Cloud Migration Playbook
Step-by-step migration framework: assessment, planning, execution, and validation with rollback procedures.
📄 Product Preview
Try the interactive reader and demo tools below, or get the full product with all content unlocked.
📖 Interactive Reader (Free Preview) ⚙ Try Demo Tools 📦 Download Free Sample📁 File Structure 22 files
📖 Documentation Preview README excerpt
Cloud Migration Playbook
A complete, battle-tested framework for migrating workloads to AWS: from initial assessment through validation, with rollback procedures and IaC templates at every stage.
This playbook is the distillation of real migration projects -- covering the 6 R's strategy, wave-based migration planning, landing zone setup, database migration via DMS, DNS cutover automation, and validation checklists. Built for cloud architects and migration leads responsible for moving production workloads.
What's Included
| Category | Files | Description |
|---|---|---|
| Terraform | landing_zone.tf, migration_hub.tf, dns_cutover.tf, dms_replication.tf, variables.tf | IaC for landing zone, Migration Hub, DMS, and DNS cutover |
| CloudFormation | migration-hub-setup.yaml | AWS Application Migration Service setup |
| Scripts | migration_readiness_checker.py, dependency_mapper.py, rollback_planner.py, wave_planner.py | Assessment, dependency mapping, rollback planning, wave scheduling |
| Docs | architecture.md, migration_phases.md, rollback_procedures.md, validation_checklist.md | Deep reference docs for every migration phase |
| Examples | wave_plan.yaml, assessment_template.json | Ready-to-use planning documents |
Migration Strategy Overview (The 6 R's)
┌─────────────┬──────────────┬───────────────────────────────────────────┐
│ Strategy │ Effort │ When to use │
├─────────────┼──────────────┼───────────────────────────────────────────┤
│ Rehost │ Low │ Lift-and-shift. Fast migration, optimize │
│ (Lift&Shift)│ │ later. Best for meeting a deadline. │
├─────────────┼──────────────┼───────────────────────────────────────────┤
│ Replatform │ Low-Medium │ Minor cloud optimizations during move. │
│ (Lift&Tinker│ │ E.g., move to managed DB (RDS). │
├─────────────┼──────────────┼───────────────────────────────────────────┤
│ Refactor │ High │ Rearchitect for cloud-native. Containers, │
│ │ │ serverless, microservices. │
├─────────────┼──────────────┼───────────────────────────────────────────┤
│ Repurchase │ Medium │ Replace with SaaS. E.g., on-prem CRM → │
│ │ │ Salesforce, Exchange → O365. │
├─────────────┼──────────────┼───────────────────────────────────────────┤
│ Retire │ None │ Decommission. No longer needed. │
├─────────────┼──────────────┼───────────────────────────────────────────┤
│ Retain │ None │ Keep on-prem. Not a fit for cloud yet. │
└─────────────┴──────────────┴───────────────────────────────────────────┘
Prerequisites
- AWS Account with Organizations set up (recommended)
- Terraform >= 1.5.0
- Python >= 3.10 (stdlib only -- no pip packages needed)
- AWS CLI configured with admin credentials for the migration account
- Network connectivity between source and target environments (VPN or Direct Connect)
Quick Start
1. Run Migration Readiness Assessment
python3 scripts/migration_readiness_checker.py
# Generates a scored assessment of your migration readiness
2. Map Application Dependencies
... continues with setup instructions, usage examples, and more.