AWS Batch runtime

Run commands remotely on AWS Batch inside the Nextstrain container image.

AWS Batch is an advanced computing platform which allows you to launch and monitor Nextstrain builds in the cloud from the comfort of your own computer. The same image used by the local Docker runtime is used by AWS Batch, making your builds more reproducible, and builds have access to computers with very large CPU and memory allocations if necessary.

Added in version 1.7.0.

Setup

The initial setup is quite a bit more involved than most runtimes, but detailed instructions are available.

Once you’ve set up AWS, proceed with nextstrain setup aws-batch.

Config file variables

Defaults for the corresponding command line options, specified in the config file.

aws-batch.job: Default for --aws-batch-job.
aws-batch.queue: Default for --aws-batch-queue.
aws-batch.s3-bucket: Default for --aws-batch-bucket.
aws-batch.cpus: Default for --aws-batch-cpus.
aws-batch.memory: Default for --aws-batch-memory.

Environment variables

Defaults for the corresponding command line options, potentially overriding defaults set by config file variables.

NEXTSTRAIN_AWS_BATCH_JOB: Default for --aws-batch-job.

NEXTSTRAIN_AWS_BATCH_QUEUE: Default for --aws-batch-queue.

NEXTSTRAIN_AWS_BATCH_S3_BUCKET: Default for --aws-batch-bucket.

NEXTSTRAIN_AWS_BATCH_CPUS: Default for --aws-batch-cpus.

NEXTSTRAIN_AWS_BATCH_MEMORY: Default for --aws-batch-memory.