ec2-aws-cdk-python

Deploy EC2 instance using the AWS CDK for Python

Setup for macOS

Make sure you do this setup first:

1. Setup macOS for AWS Cloud DevOps

2. AWS Authentication

3. Install AWS CDK on macOS

4. For Python support, install pyenv:

   brew install pyenv

Development

Configure project:

source configure.sh

Open in Visual Studio Code:

code .

Deploy

Print the CloudFormation template for the stack. You should see the CloudFormation template without any errors:

cdk synth --profile default

Bootstrap the CDK environment. This should be done only once per account. Skip this step if you have done it already. See Bootstrapping for details:

cdk bootstrap --profile default

Deploy the stack:

cdk deploy --profile default

Test Deployment

Check that you can browse the nginx default site:

key="aws-ec2-key"
instance="NginxEc2Stack/NginxInstance"

instance_public_ip=$(aws ec2 describe-instances \
    --filters \
       Name=tag:Name,Values=$instance \
        Name=instance-state-name,Values=running \
| jq -r '.Reservations[0].Instances[0].PublicIpAddress')

open http://$instance_public_ip

Cleanup

cdk destroy --profile default

Opptional: To delete the CDKToolkit CloudFormation template which is created by the AWS CDK during bootstrap:

aws cloudformation delete-stack --stack-name CDKToolkit --profile default

The bootstrap process creates an S3 Bucket with a name: cdk-<hash>-assets-<account_id>-<region>. This bucket will not be deleted automatically and will remain in your account if not deleted manually.

How to create a new project

# Node.js
nvm use 20.16.0

# Python
mkdir ec2-aws-cdk-python
cd ec2-aws-cdk-python
cdk init app --language python --generate-only

mv README.md README_MDK.md