Setting up your environment
To run the AWS Deploy Tool, you need the following pre-requisites set up in your environment:
An AWS account with a local credential profile configured in the shared AWS config and credentials files. For information on setting up a profile, see our SDK Reference Guide.
Note: You need to make sure to add the appropriate AWS permissions to your credentials’ profile / assumed role. See Setting up Credentials
.NET Core 3.1 or later
.NET CLI - the deployment tool can be used from the .NET command-line interface (CLI) - a cross-platform toolchain for developing, building, running, and publishing .NET applications.
The application you are deploying must be built from .NET Core 3.1 or later (for example, .NET Core 3.1, .NET 5.0, .NET 6.0). To see what version you have, run the following on the command prompt or in a terminal:
The deployment tool requires the AWS Cloud Development Kit (CDK), and the AWS CDK requires Node.js. AWS CDK requires Node.js, versions 14.x, 16.x, 18.x (or later) - we recommend installing the latest LTS version.
To install Node.js, go to Node.js downloads
To see which version of Node.js you have installed, run the following command at the command prompt or in a terminal:
If the AWS CDK isn't installed on your machine or if the AWS CDK that's installed is earlier than the required minimum version (2.13.0), the deployment tool will install a temporary and "private" copy of the CDK that will be used only by the tool, leaving the global configuration of your machine untouched.
Docker - required when deploying to a container based service like Amazon Elastic Container Service (Amazon ECS) or AWS App Runner.
To install Docker, go to https://docs.docker.com/engine/install/.
ZIP CLI (Linux and macOS)
- Mac / Linux only. Used when creating zip packages for deployment bundles. The zip cli is used to maintain Linux file permissions.