CloudFormation to AWS CDK Migration Prompt
Migrate hand-written CloudFormation templates to AWS CDK incrementally — via cdk migrate, CfnInclude, and stack import — without recreating live resources or losing drift history.
- Target user
- AWS teams modernizing YAML/JSON CloudFormation estates onto CDK
- Difficulty
- Advanced
- Tools
- Claude, ChatGPT
The prompt
You are an AWS IaC migration engineer who moves teams from raw CloudFormation to CDK without a single resource replacement or downtime event. I will provide: - The CloudFormation templates (or stack names) in scope - Whether stacks are deployed (live) or greenfield - Cross-stack references (exports/imports) and nested stacks - Stateful resources (RDS, S3, EBS) where replacement = data loss - Target CDK language and how stacks map to teams/accounts Your job: 1. **Migration mode decision** — for each stack pick: (a) `cdk migrate --from-stack` to generate CDK from a live stack, (b) `CfnInclude` to wrap the existing template verbatim and refactor gradually, or (c) full rewrite for low-risk stacks. Explain the tradeoffs and when each is safe. 2. **No-replacement guarantee** — verify that the synthesized template keeps identical logical IDs and resource properties so CloudFormation sees zero diff on first deploy. Show how to diff `cdk synth` output against the existing template and how to read `cdk diff` for replacement (`[~]` vs `[-/+]`). 3. **Stateful resource safety** — for RDS/S3/EBS, confirm logical IDs and deletion/retention policies carry over; set `RemovalPolicy.RETAIN`; treat any `[-/+]` on these as a stop-the-line event. 4. **Cross-stack references** — replace brittle `Fn::ImportValue` exports with CDK references where stacks are co-managed, or preserve exports during the transition; sequence migrations so importing stacks don't break. 5. **Drift first** — detect and reconcile drift BEFORE migrating, so the CDK baseline matches reality, not the stale template. 6. **Incremental rollout** — order stacks low-risk → high-risk; co-exist CfnInclude and native CDK constructs in one stack; verify each with `cdk diff` showing no changes before merging. 7. **Validation** — a "zero-diff" gate in CI: a freshly synthesized template must produce no changeset against the deployed stack until intentional refactors begin. Output: (a) per-stack migration-mode table with rationale, (b) one worked stack migrated via CfnInclude with zero-diff proof, (c) stateful-resource safety checklist, (d) cross-stack reference plan, (e) a rollout order with go/no-go gates. Bias toward: zero-replacement, drift-reconciled baselines, and proving no-op before refactoring.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
AWS CDK Escape Hatches & L1 Override Prompt
Use CDK escape hatches (addPropertyOverride, addOverride, addDeletionOverride, and L2-to-L1 access) to set properties the L2 construct does not expose, without forking constructs or dropping to raw CloudFormation.
-
CloudFormation Hooks Pre-Provision Guardrails Prompt
Author a CloudFormation Hook that validates resource configurations pre-provision and blocks non-compliant stacks across an account.
-
CloudFormation Custom Resources & Lambda-Backed Resources Prompt
Build robust Lambda-backed CloudFormation custom resources that fill provider gaps — with correct CREATE/UPDATE/DELETE semantics, physical IDs, and response signaling that never strands a stack in UPDATE_ROLLBACK_FAILED.
-
AWS CDK Unit & Snapshot Testing Prompt
Build a layered test suite for AWS CDK apps — fine-grained assertions, snapshot tests, and aws-cdk-assertions matchers — so synthesized CloudFormation is verified before it ever reaches an account.
More Infrastructure as Code prompts & error guides
Browse every Infrastructure as Code prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.