Overview
alto.yml
infra
key should contain a set of key-value pairs that describe infrastructure on
which to run your code. Different kinds of infrastructures will have different
acceptable key-value pairs; however, they all must have a value for type
.
If your
infra
does not contain a type
key, then Alto will throw an error!type
values.
EC2
Prerequisites
EC2 agents rely on the boto3 and botocore packages. These require you to set up authentication credentials for your AWS account. More information can be found here.You must configure your Boto3 credentials in order to use EC2 agents.
IAM permissions
EC2 agents require your AWS credentials to list, modify, create, and delete certain resources (e.g., key pairs, security groups, EC2 instances, etc.). You’ll need to make sure your account has the necessary privileges to create EC2 instances, security groups, and key-pairs. Contact your account administrator to help out with this. You can use the following policy document to provision your account with the necessary permissions:IAM policy document
IAM policy document
Key Specification
The EC2infra
accepts the following keys:
Required keys
type
: this should always beec2
instance_type
: the EC2 instance type. This defaults tot2.micro
. The list of all available EC2 instance types can be found here.ami_image
: the Amazon machine image to use. This defaults to ami-0889a44b331db0194. You should be able to find a list of available AMIs for your region via the AWS console (EC2 >> Images >> AMI Catalog).
Your
ami_image
must be an Amazon Linux AMI. We’re working on adding support for
other Linux-based images (e.g., Debian, Ubuntu, etc.)Optional keys
python_version
: the Python version to use. This is optional. If this isn’t specified, this your code will run using the Python version native to the EC2 instance. The latest version is always used, i.e.,:python_version: 3
—> version3.12.0
is usedpython_version: 3.1
—> version3.1.5
is usedpython_version: 3.11.6
—> version3.11.6
is used
Installing a custom python_version takes a while! If you’re still experimenting,
make sure to use the
--no-delete-success
and --no-delete-failure
flags to preserve your
cloud environment.Important:
python_version
will be ignored if you use an image container to
run your code.Example
Here’s a simple configuration for an EC2 agent:alto.yml