Bootstrap CDK

One-time setup to prepare an AWS account for CDK deployments.

What It Does

Creates a CDKToolkit CloudFormation stack containing:

• S3 bucket for storing CDK assets (Lambda code, Docker images, etc.)
• IAM roles for CDK deployments
• ECR repository for Docker image assets

When to Run

• First time deploying CDK to an AWS account
• Only needs to be done once per account/region pair

Check If Already Bootstrapped

AWS_PROFILE=orcha-prod aws cloudformation describe-stacks \
  --stack-name CDKToolkit \
  --region eu-central-1 \
  --query 'Stacks[0].StackStatus' \
  --output text

If you see CREATE_COMPLETE or UPDATE_COMPLETE, it's already bootstrapped. If you see "Stack with id CDKToolkit does not exist", you need to bootstrap.

Run

cd /home/volrath/code/orcha/infra
source .venv/bin/activate
AWS_PROFILE=orcha-prod cdk bootstrap aws://700558745280/eu-central-1

Verify

AWS_PROFILE=orcha-prod aws cloudformation describe-stacks \
  --stack-name CDKToolkit \
  --region eu-central-1 \
  --query 'Stacks[0].StackStatus' \
  --output text
# Should return: CREATE_COMPLETE

Notes

• Bootstrap is account+region specific (eu-central-1 for Orcha)
• The CDKToolkit stack is managed by AWS CDK, don't modify it manually
• Safe to re-run bootstrap - it will update if needed