Docker AWS CDK

Containerised AWS CDK to ensure consistent local development and simple CD pipelines.

Usage

Run as a command using cdk as entrypoint:

docker run --rm --entrypoint cdk contino/aws-cdk --version

Run as a shell and mount .aws folder and current directory as volumes:

docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/opt/app contino/aws-cdk bash

Using docker-compose:

cdk:
    image: contino/aws-cdk
    env_file: .env
    entrypoint: aws
    working_dir: /opt/app
    volumes:
    - ~/.aws:/root/.aws
    - .:/opt/app:rw

And run docker-compose run cdk --version

Language Support

CDK Supports different languages to define your (re)usable assets.

JavaScript/TypeScript

This should work out of the box through package.json and node_modules, which are automatically cached in your working directory.

Python

This image ships with Python 3 installed. To cache installed cdk python packages, site-packages is exposed as a volume. This allows you to cache packages between invocations:

cdk:
    ...
    volumes:
    - cdk-python:/usr/lib/python3.7/site-packages/
    - ...
volumes:
    cdk-python

Then, if you install e.g. aws-cdk.core through pip (pip3 install aws-cdk.core) in a container, you won't have to install it again next time you start a new container.

Java

Not supported in this image yet

Build

Update the AWS_CDK_VERSION in both Makefile and Dockerfile. The run:

make build

Docker Hub will automatically trigger a new build.

Updates

To update this container with a newer version of the AWS CDK:

1. Update the Dockerfile with the new AWS CDK version number
2. Update the Dockerfile with a new Alpine container version (if applicable)
3. Update the Makefile with the new AWS CDK version number
4. Submit pull request and get approved

Related Projects

• docker-aws-cli
• docker-terraform