aws-cdk-templates 🚀

The goal of this project is to create templates to deploy AWS infrastructure using AWS CDK. This project has three main types of directories;

1. deploy-* directories deploy AWS infrastructure. Each directory has its own README describing the deployment process.
2. The api directory describes how to build a docker image out of a simple Micronaut application.
3. lambda-handler* directories contain Lambda handlers referenced by some of the deployers.

One of the major benefits of deploying AWS infrastructure using AWS CDK is that the infrastructure can be deployed and destroyed programmatically and every deployment is identical. This allows for quick and easy cleanup as well as rapid prototyping.

These deployment examples are meant to be used as an opportunity to learn about AWS infrastructure and should not be used in production environments.

Warning

The deployment of some of these CDK stacks cost money! To reduce costs, always destroy the deployment when it is no longer in use!

Installing the AWS CDK 🛠️

npm install -g aws-cdk

After installing the CDK, install the AWS CLI and bootstrap the CDK to your AWS environment.

A note on Windows 📎

Git Bash

If using Windows it is recommended to run cdk commands using the Git Bash command line, Git Bash is included with the Git installation. Since Git Bash doesn't support TTY all cdk commands must be prefixed with winpty, for example, instead of executing cdk deploy, execute winpty cdk.cmd deploy (NodeJS must be on PATH for this to work).

7 Zip

The Lambda handlers' build process needs a compression library to zip the distribution files, since Windows doesn't ship with a command line compression library, 7 Zip must be installed to compress the distribution files.

Where to begin

You should begin deploying what interests you but one of the simplest examples are deploy-ec2-instance or deploy-lambda. Once these deployments are easily understood move to some of the more complex examples; deploy-vpc-l1 or deploy-vpc-to-vpc-transit-gateway.