Q: A module output used by several other modules is changing format from a string to an object. How do you migrate safely?
Introduce the new output alongside the old one first, keep both during a transition period, and update consumers incrementally. Once all consumers use the new output, remove the old one in a versioned breaking release.
Want to master this scenario in a live sandbox? KodeKloud's HashiCorp Certified Terraform Associate (003) Interactive Labs covers this exact problem with hands-on terminal drills.
🛠️ Production Runbook & Step-by-Step Resolution
Direct Answer: "When terraform plan shows unexpected changes, my golden rule is: never apply blindly. Investigate the diff first. When addressing this question, I walk the interviewer through our production incident runbook: isolating the blast radius, checking diagnostic logs and metrics, and applying a safe fix."
Production Solution & Architecture
Introduce the new output alongside the old one first, keep both during a transition period, and update consumers incrementally. Once all consumers use the new output, remove the old one in a versioned breaking release. Output changes are API changes for Terraform modules, so they need the same care as application interface changes.
- Immediate Triage: Introduce the new output alongside the old one first, keep both during a transition period, and
- Run targeted verification commands before modifying configuration.
- Automate permanent guardrails (CI check, alerts, IaC policy) to prevent recurrence.
Senior hiring managers and bar raisers evaluate how you prioritize during outages. Avoid these common anti-patterns:
- Executing Terraform applies without inspecting '# forces replacement' warnings in plan output when configuring module output used Attributes that force resource replacement destroy and recreate critical infrastructure (databases, load balancers), inducing unannounced production outages.
- Omitting remote state locking mechanisms (DynamoDB or backend native locks) for shared state files when configuring module output used Without state locking, concurrent CI/CD pipeline executions or team applies create race conditions that corrupt the state file.
- Structuring entire enterprise cloud footprints into a single monolithic Terraform root module when configuring module output used Monolithic state files slow plan execution dramatically, increase blast radius during failed applies, and create severe pipeline locking contention.
- Failing to pin required_providers versions, causing breaking provider upgrades in CI pipelines when configuring module output used Unpinned provider versions automatically download breaking major upgrades during CI runs, introducing unexpected schema validation failures.