Setup
Account activation
To start using Amazon Genomics CLI with your AWS account, you need to activate it.
agc account activate
This will create the core infrastructure that Amazon Genomics CLI needs to operate, which includes a DynamoDB table, an S3 bucket and a VPC. This will take ~5min to complete. You only need to do this once per account region.
The DynamoDB table is used by the CLI for persistent state. The S3 bucket is used for durable workflow data and Amazon Genomics CLI metadata and the VPC is used to isolate compute resources. You can specify your own preexisting S3 Bucket or VPC if needed using --bucket
and --vpc
options.
CDK Bootstrap
Attention
This step is NOT required when using Amazon Genomics CLI version 1.2 or aboveAmazon Genomics CLI uses AWS CDK to deploy infrastructure. Activating an account will bootstrap the AWS Environment for CDK app deployments. CDK Bootstrap deploys the infrastructure needed to allow CDK to deploy CDK defined infrastructure. Full details are available here.
Define a username
Amazon Genomics CLI requires that you define a username and email. You can do this using the following command:
agc configure email you@youremail.com
The username only needs to be configured once per computer that you use Amazon Genomics CLI from.