Learning some CDK by following this workshop
Follow the workshop instructions to get the following setup:
- AWS CLI
- AWS Account and User (make a note of the profile name)
- Node.js
Create a Python 3 virtualenv and install the requirements
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
Add an .env
at project root level with the following variable and add the AWS region e.g.
CDK_DEFAULT_REGION=eu-west-2
# activate the venv
source venv/bin/activate
# use the correct version of NPM
nvm use
# any cdk commands need to include the profile option along with the profile name
# if you have more than one AWS profile and don't want to use the default
cdk bootstrap --profile {profileName}
(The docs below are created as part of the cdk init sample-app --language python
command)
You should explore the contents of this project. It demonstrates a CDK app with an instance of a stack (cdkworkshop_stack
)
which contains an Amazon SQS queue that is subscribed to an Amazon SNS topic.
The cdk.json
file tells the CDK Toolkit how to execute your app.
This project is set up like a standard Python project. The initialization process also creates
a virtualenv within this project, stored under the .env directory. To create the virtualenv
it assumes that there is a python3
executable in your path with access to the venv
package.
If for any reason the automatic creation of the virtualenv fails, you can create the virtualenv
manually once the init process completes.
To manually create a virtualenv on MacOS and Linux:
$ python3 -m venv .env
After the init process completes and the virtualenv is created, you can use the following step to activate your virtualenv.
$ source .env/bin/activate
If you are a Windows platform, you would activate the virtualenv like this:
% .env\Scripts\activate.bat
Once the virtualenv is activated, you can install the required dependencies.
$ pip install -r requirements.txt
At this point you can now synthesize the CloudFormation template for this code.
$ cdk synth
You can now begin exploring the source code, contained in the hello directory. There is also a very trivial test included that can be run like this:
$ pytest
To add additional dependencies, for example other CDK libraries, just add to
your requirements.txt file and rerun the pip install -r requirements.txt
command.
cdk ls
list all stacks in the appcdk synth
emits the synthesized CloudFormation templatecdk deploy
deploy this stack to your default AWS account/regioncdk diff
compare deployed stack with current statecdk docs
open CDK documentation
Enjoy!