Skip to main content

Migration Guides

This section provides detailed migration guides for upgrading between major versions of NTC modules. Each guide includes step-by-step instructions, breaking changes, and best practices to ensure a smooth transition.

Available Migration Guides​

TFState Backend Template v4​

Target Release: NTC Account Baseline Templates v4.0.0

Major changes in v4:

  • ✅ Regional TFState Backend Buckets - Opt-in support for S3 state buckets per baseline region
  • ⚠️ Breaking Change - All tfstate backend resources re-keyed from index/unkeyed to for_each with region keys — state migration required

v1.x → v2.x Migration​

Target Release: NTC Modules v2.0.0 (Gradual rollout starting Q4 2025)

Major changes in v2:

  • ✅ AWS Provider v6 Support - New region attribute architecture (1 provider, N regions)
  • ✅ AWS European Sovereign Cloud (ESC) Compatibility - Full support for sovereign cloud environments
  • ✅ Simplified Module Architecture - Consolidated module calls (e.g. 1 module call instead of 3)
  • ✅ Breaking Changes - Provider upgrades and module refactoring
When to Migrate

You must migrate to v2.x if you:

  • Want to use AWS Terraform Provider v6.x
  • Need to deploy to AWS European Sovereign Cloud (ESC)
  • Want simplified module configurations

You can continue using v1.x if:

  • You're satisfied with AWS Terraform Provider v5.x
  • You only use AWS Commercial or GovCloud partitions
  • You prefer to migrate at your own pace
Migration Timeline

NTC modules v2 are being released gradually over the coming weeks. Each module can be upgraded independently, allowing you to plan your migration strategy based on your organization's needs.

Migration Support​

If you need assistance with your migration:

  • 📚 Review the module-specific migration guides
  • 🐛 Check the troubleshooting section
  • 💬 Contact NTC Support via your usual channels

Best Practices​

  1. Test First: Always test the migration in a non-production environment
  2. Gradual Rollout: Migrate one module/project at a time
  3. State Backups: Create Terraform state backups before migrating
  4. Review Breaking Changes: Read the module-specific migration guides thoroughly
  5. Plan Downtime: Some migrations may require brief service interruptions

Last Updated: December 2024