AWS deployment requirements
- Node for Architect
- Python for the AWS CLI
- Any additional supported runtimes you plan to use
- AWS CLI
- AWS credentials
- Architect CLI
Architect supports the following runtime versions:
Working locally with the Architect
sandboxrequires target runtimes to be available in your
To change the default runtime add it to the
app.arc under the
# Valid runtimes: # - nodejs12.x (default) # - deno # - python3.8 # - ruby2.5 @aws runtime python3.8
This setting can be overridden on a function-by-function basis with
Architect supports the following standard AWS managed runtimes in live infra, but not while working locally (at present):
The AWS Command Line Interface is the main interface for interacting with all parts of AWS using your computer's terminal. Architect uses the AWS CLI to package and deploy CloudFormation. Follow this guide to installing the AWS CLI for your preferred environment.
You'll need an Amazon Web Services account and credentials set up on your development machine. If you haven't done it before, here's a useful guide for Configuring the AWS CLI.
On *nix systems AWS Credentials are listed in:
Or on Windows systems:
If that file doesn't exist, create it, and add something like the following (assuming you have multiple AWS accounts):
[default] aws_access_key_id=xxx aws_secret_access_key=xxx [work] aws_access_key_id=xxx aws_secret_access_key=xxx [personal] aws_access_key_id=xxx aws_secret_access_key=xxx
You will also need to set a default profile and region with the environment variables
To set these variables on Linux, macOS, or UNIX, use export in your
~/.bashrc (or equivalent shell configuration):
export AWS_PROFILE=work export AWS_REGION=us-west-1
Or for Windows, add this to your PowerShell
If you prefer, you can also use: Control Panel » System » Advanced System Settings » Environment Variables.
The following command uses
npm, the package manager for Node, to install Architect and the AWS SDK globally. This will allow you to use Architect in any directory on your computer.
npm i -g @architect/architect aws-sdk
Or, if you prefer, you can install Architect locally into a project:
npm init @architect ./testapp