Runbook: Coordinate a Cross-Team Terraform Change

1 · Prerequisites

Confirm every item is in place before any state change.

• Multiple teams affected by the change
• Change is scheduled

2 · Pre-checks

Read-only diagnostic commands. If any of these don't match expected output, stop and investigate further.

• · All teams are aware of the change
• · The change is documented

3 · Procedure

Execute each step in order. Verify the expected output of a step before moving to the next.

1. 1Coordinate the change window
2. 2Apply the change in staging
3. 3Verify the change in staging
4. 4Apply the change in production
5. 5Verify the change in production
6. 6Document the change

4 · Verification

Confirm the procedure actually fixed the problem.

• ✓Change is applied in all environments
• ✓Plan is empty in all environments
• ✓Change is documented

5 · Rollback

If verification fails, undo the procedure in reverse order.

• ↶If the change fails, revert to the previous state in all environments

6 · Escalation

When the runbook isn't enough, contact:

• · If the change breaks production, escalate to incident response