README
¶
AWS Provider for Devsy
Getting started
The provider is available for auto-installation using
devsy provider add aws
devsy provider use aws
Follow the on-screen instructions to complete the setup.
Needed variables will be:
- AWS_REGION or AWS_DEFAULT_REGION
The provider will inherit the login information from aws cli or you can
specify in your environment, or in the provider options, the AWS_ACCESS_KEY_ID=
and AWS_SECRET_ACCESS_KEY=
Creating your first devsy env with aws
After the initial setup, just use:
devsy up .
You'll need to wait for the machine and environment setup.
Customize the VM Instance
This provider has the following options
| NAME | REQUIRED | DESCRIPTION | DEFAULT |
|---|---|---|---|
| AWS_AMI | false | The disk image to use. | latest ubuntu in the region with proper architecture for the instance |
| AWS_DISK_SIZE | false | The disk size to use. | 40 |
| AWS_ROOT_DEVICE | false | The ID of the root device. | The RootDeviceName property of the AMI, or /dev/sda1 if undefined |
| AWS_INSTANCE_TYPE | false | The machine type to use. | c5.xlarge |
| AWS_REGION | true | The aws cloud region to create the VM | |
| AWS_VPC_ID | false | The vpc id to use. | |
| AWS_SECURITY_GROUP_ID | false | The security group ID is a comma separated list of IDs for the VM | created if not specified |
| AWS_SUBNET_ID | false | The subnet ID for the VM | created if not specified |
| AWS_INSTANCE_TAGS | false | Additional flags for the VM in the form of "Name=XXX,Value=YYY " | |
| AWS_INSTANCE_PROFILE_ARN | false | The ARN of the instance profile to use for the VM | created if not specified |
You will need a user profile able to:
- Create/Start/Stop/Destroy instances
- Create/Destroy security groups
- Create/Destroy subnets
- Create/Destroy instance profiles
Alternatively you'll need to provide the IDs/ARNs of the already created resources. Instance Create/Start/Stop/Destroy permissions are mandatory for how the provider itself works.
Options can either be set in env or on the command line, for example:
devsy provider set-options -o AWS_AMI=my-custom-ami
You can use a variety of AWS_INSTANCE_TYPE, from this list, they include AMD, Intel and ARM64 instances, the list is automatically suggested when using the GUI application.
Local Development
To build and test the provider locally, use task task build:provider:dev. The provider file is created in ./dist/provider.yaml.
Documentation
¶
There is no documentation for this package.
Source Files
Directories