rohan-buechner / aws-cdk-examples

A set of samples I used to experiment with AWS CDK

AWS CDK Samples

A set of samples I used to experiment with AWS CDK.

Preparation to work with AWS CDK

Install AWS CDK

$ sudo apt install -yqq nodejs npm

$ sudo npm i -g aws-cdk

Versions used in these projects are:

$ nodejs -v
v10.19.0

$ npm -v
6.14.4

$ cdk --version
1.91.0 (build 0f728ce)

Creating a new AWS CDK project

$ mkdir <project-name> && cd <project-name>

$ cdk init --language=typescript

Available projects in this repository

Some CDK examples have been included as subdirectories. They are:

$ git clone <repo>

$ tree . -d -L 1
.
├── code-server-ec2
├── code-server-ecs
├── lambda-tokenization
├── simple-ec2
├── simple-frontend-backend-ecs
└── simple-php-ts-ecs

References

• AWS CDK
• AWS CDK Documentation
• AWS CDK Examples

Troubleshooting

1. Incompatibility of dependencies

unable to determine cloud assembly output directory. Assets must be defined indirectly within a "Stage" or an "App" scope
Subprocess exited with error 1

⨯ Unable to compile TypeScript:
lib/simple-frontend-backend-ecs-stack.ts:12:29 - error TS2345: Argument of type 'this' is not assignable to parameter of type 'Construct'.

Reference:

• aws/aws-cdk#9578

Solution:

It's because your dependencies aren't aligned. You'll need the same version of all the CDK packages. Align the subtle difference in the list of CDK modules in the package.json. You should have something like this:

[...]
  },
  "dependencies": {
    "@aws-cdk/aws-ec2": "1.57.0",
    "@aws-cdk/aws-ecr": "1.57.0",
    "@aws-cdk/aws-ecr-assets": "1.57.0",
    "@aws-cdk/aws-ecs": "1.57.0",
    "@aws-cdk/aws-ecs-patterns": "1.57.0",
    "@aws-cdk/aws-logs": "1.57.0",
    "@aws-cdk/core": "1.57.0",
    "source-map-support": "0.5.16"
  }
}

Set up the same version updating the package.json, then remove node_modules folder and package-lock.json file and re-import all modules running npm install.

2. Docker is not installed

CDK can not build the Docker images required for your project.

...
[0%] start: Publishing a0e03e994b7d88ba9c688c24b33ee785b12e591b4188fdfd1acddb8865270899:current
[100%] fail: write EPIPE

 ❌  SimpleFrontendBackendEcsStack failed: Error: Failed to publish one or more assets. See the error messages above for more information.
Error: spawn docker ENOENT
    at Process.ChildProcess._handle.onexit (internal/child_process.js:240:19)
    at onErrorNT (internal/child_process.js:415:16)
    at process._tickCallback (internal/process/next_tick.js:63:19)

Solution:

You need to install Docker in your local computer.

$ sudo apt install -y docker.io
$ sudo systemctl enable --now docker
$ sudo apt-mark hold docker.io
$ sudo usermod -aG docker $USER

// check the installation
$ docker --version
Docker version 19.03.8, build afacb8b7f0

$ sudo docker container run hello-world

// cleanning installation
$ sudo docker container stop $(docker container ls -aq)
$ sudo docker system prune -a --volumes

// you can now uninstall Docker as any other package installed with apt
$ sudo apt purge docker.io
$ sudo apt autoremove

3. Docker is installed but it isn't working

We have installed Docker but it still is not working.

...
[0%] start: Publishing a0e03e994b7d88ba9c688c24b33ee785b12e591b4188fdfd1acddb8865270899:current
[100%] fail: docker login --username AWS --password-stdin https://263455585760.dkr.ecr.us-east-1.amazonaws.com exited with error code 1: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post http://%2Fvar%2Frun%2Fdocker.sock/v1.40/auth: dial unix /var/run/docker.sock: connect: permission denied

 ❌  SimpleFrontendBackendEcsStack failed: Error: Failed to publish one or more assets. See the error messages above for more information.
Failed to publish one or more assets. See the error messages above for more information.

Solution:

Once Docker has been installed, you have to restart your computer. If it already has been installed, you can check its status to see if it is disabled, if so, you have to execute this:

$ sudo systemctl status docker
$ sudo systemctl enable --now docker
$ sudo systemctl start docker