Add a Provider
The Devsy team maintains providers for popular services such as:
- Docker (docker)
- Kubernetes (kubernetes)
- SSH (ssh)
- AWS (aws)
- Google Cloud (gcloud)
- Azure (azure)
- Digital Ocean (digitalocean)
These providers can be installed with the Devsy CLI in the following form:
devsy provider add docker
You can get a list of available 1st party providers by using the command:
devsy provider list-available
Via Devsy Desktop Application
Navigate to the 'Providers' view and click on the 'Add' button in the title. Select one of the providers supplied by default, or click on the '+' button to add a custom one.
You will be prompted to fill some additional settings if needed, depending on the provider's needs.
Under the hood, the Desktop Application will call a devsy provider add PROVIDER
Adding a custom provider
After you click the Add button in the Providers section, you can click the
big + button to add a custom provider, then fill the Source section with either
- A GitHub link to the provider's project
- An URL to a
provider.yaml - A File Path to a
provider.yaml
Via Devsy CLI
The providers in this list can easily be installed like:
devsy provider add docker
devsy provider add kubernetes
devsy provider add ssh
devsy provider add aws
devsy provider add azure
devsy provider add gcloud
devsy provider add digitalocean
You can use the --name flag to add multiple providers of the same type with different options, for example devsy provider add aws --name aws-gpu -o AWS_INSTANCE_TYPE=p3.8xlarge
From GitHub
You can specify a custom provider, directly from GitHub, by using the format
my-username/repo, so for example:
devsy provider add devsy-org/devsy-provider-terraform
Devsy will search the latest release for a provider.yaml and download that automatically. This should work for private GitHub repositories where Devsy will use the local https credentials to connect to the GitHub repository.
If you want to install the provider from a different release, you can do the following:
devsy provider add my-org/[email protected]
From Local Path
If you have locally downloaded providers, you can also add them directly to
Devsy, by pointing to the file path of provider.yaml manifest:
devsy provider add ../devsy-provider-mock/provider.yaml
From URL
You can also specify the URL to the provider.yaml file, for example:
devsy provider add https://github.com/devsy-org/devsy-provider-ssh/releases/download/v0.0.3/provider.yaml
Set Provider Options
Each provider has a set of options, those options can be different for each of them, as they are defined by the provider's developers.
Managing options from Devsy Desktop Application
To manage options from the app, head over the Providers section, and click
Edit on the provider you want to configure.
Managing options from Devsy CLI
Options for providers can be set during the use or add phase:
devsy provider add <provider-name> -o KEY=value
or
devsy provider use <provider-name> -o KEY=value
Else, to can manage options afterwards from CLI, you can list the table of provider's options by using:
devsy provider options <provider-name>
An example output for the AWS Provider is:
NAME | REQUIRED | DESCRIPTION | DEFAULT | VALUE
----------------------------+----------+--------------------------------+-------------------------+--------------------------
AGENT_PATH | false | The path where to inject the | /var/lib/toolbox/devsy | /var/lib/toolbox/devsy
| | Devsy agent to. | |
AWS_ACCESS_KEY_ID | false | The AWS access key id | |
AWS_AMI | false | The disk image to use. | |
AWS_DISK_SIZE | false | The disk size to use. | 40 | 40
AWS_INSTANCE_TYPE | false | The machine type to use. | c5.xlarge | c5.xlarge
AWS_REGION | true | The AWS cloud region to create | | us-west-2
| | the VM in, e.g. us-west-1 | |
AWS_SECRET_ACCESS_KEY | false | The AWS secret access key | |
AWS_VPC_ID | false | The vpc id to use. | |
INACTIVITY_TIMEOUT | false | If defined, will automatically | 10m | 10m
| | stop the VM after the | |
| | inactivity period. | |
INJECT_DOCKER_CREDENTIALS | false | If Devsy should inject docker | true | true
| | credentials into the remote | |
| | host. | |
INJECT_GIT_CREDENTIALS | false | If Devsy should inject git | true | true
| | credentials into the remote | |
| | host. | |
You can see this table as an overview, you can change each option using:
devsy provider set-options <provider-name> --option <KEY>=<VALUE>
So for example, to change the default disk size from 40gb to 120gb, you could use:
devsy provider set-options aws --option AWS_DISK_SIZE=120
And check again the options for the provider using devsy provider options aws:
NAME | REQUIRED | DESCRIPTION | DEFAULT | VALUE
----------------------------+----------+--------------------------------+-------------------------+--------------------------
AGENT_PATH | false | The path where to inject the | /var/lib/toolbox/devsy | /var/lib/toolbox/devsy
| | Devsy agent to. | |
AWS_ACCESS_KEY_ID | false | The aws access key id | |
AWS_AMI | false | The disk image to use. | |
AWS_DISK_SIZE | false | The disk size to use. | 40 | 120
AWS_INSTANCE_TYPE | false | The machine type to use. | c5.xlarge | c5.xlarge
AWS_REGION | true | The aws cloud region to create | | us-west-2
| | the VM in, e.g. us-west-1 | |
AWS_SECRET_ACCESS_KEY | false | The aws secret access key | |
AWS_VPC_ID | false | The vpc id to use. | |
INACTIVITY_TIMEOUT | false | If defined, will automatically | 10m | 10m
| | stop the VM after the | |
| | inactivity period. | |
INJECT_DOCKER_CREDENTIALS | false | If Devsy should inject docker | true | true
| | credentials into the remote | |
| | host. | |
INJECT_GIT_CREDENTIALS | false | If Devsy should inject git | true | true
| | credentials into the remote | |
| | host. | |
Single Machine Provider
By default, Devsy will use a separate machine for each workspace using the same provider,
you can enable Reuse machine in a provider in order to use a single machine for all workspaces.
In the desktop app the option is available in the option management interface for the provider (see section above)
In the CLI you can set this option using:
devsy provider use <provider-name> --single-machine
Default Provider
When adding a provider to Devsy, you can specify it to be the default provider, this implies that when you create a Workspace, this provider will be used if no other is specified.
In the desktop app, you can set a provider to be default in the option management interface for the provider (see section above)
In the CLI you can set this option using:
devsy provider use <provider-name>
Community Providers
The community maintains providers for additional services.
- Cloudbit (cloudbit-ch/devsy-provider-cloudbit)
- Flow (flowswiss/devsy-provider-flow)
- Hetzner (mrsimonemms/devsy-provider-hetzner)
- OVHcloud (alexandrevilain/devsy-provider-ovhcloud)
- Scaleway (dirien/devsy-provider-scaleway)
- Exoscale (dirien/devsy-provider-exoscale)
- Multipass (minhio/devsy-provider-multipass)
- Open Telekom Cloud (akyriako/devsy-provider-opentelekomcloud)
- Vultr (navaneeth-dev/devsy-provider-vultr)
- STACKIT (stackitcloud/devsy-provider-stackit)
- Podman (kuju63/devsy-provider-podman)
These providers can be installed with the Devsy CLI in the following form:
devsy provider add <user/repository>