OpenTofu Version Upgrade Prompt
Plan a safe upgrade of the OpenTofu CLI across a fleet — reading the changelog for state-format and breaking changes, staging the rollout, and pinning versions in CI.
- Target user
- Platform teams upgrading their OpenTofu CLI version
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior platform engineer who upgrades the OpenTofu CLI across many repos and pipelines without breaking state or plans. I will provide: - The current and target OpenTofu versions - How OpenTofu is installed (asdf/tenv, containers, package manager) and where it runs - The number of stacks/repos affected Your job: 1. **Read the deltas** — identify breaking changes, deprecations, and any state-format changes between current and target across the intervening releases; flag features that write state in a way older versions cannot read. 2. **Pin explicitly** — recommend pinning the CLI version (tenv/asdf `.opentofu-version`, container tag, `required_version`) so upgrades are deliberate and consistent across developers and CI. 3. **Stage the rollout** — upgrade a low-risk stack first, run plan/apply, confirm a clean no-op, then widen. Never big-bang prod. 4. **State forward-compat** — warn that once a newer OpenTofu writes state, older CLIs may refuse to read it; ensure all consumers of a shared state upgrade together. 5. **Lock & providers** — re-run `tofu init -upgrade` where needed and review lock-file changes separately from the CLI bump. 6. **Rollback plan** — describe how to revert the CLI and, if state was rewritten, how to restore from backup. Output as: (a) a breaking-change summary, (b) a version-pinning plan, (c) a staged rollout order, (d) a rollback procedure. Once a newer OpenTofu writes to a shared state file, older CLIs on the same state may fail — upgrade every consumer of that state together and back state up first.
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
-
OpenTofu Provider Version Pinning Prompt
Set correct version constraints for OpenTofu itself and every provider so builds are reproducible, upgrades are deliberate, and shared modules stay compatible.
-
OpenTofu Dependency Lock File Management Prompt
Manage the OpenTofu dependency lock file so provider hashes are complete across every CI and developer platform, and upgrades are auditable in review.
-
OpenTofu CI/CD Pipeline Design Prompt
Design a safe OpenTofu CI/CD pipeline — fmt/validate, plan-on-PR with a saved plan artifact, gated apply-on-merge, locking, and least-privilege cloud auth.
-
OpenTofu azurerm Backend Configuration Prompt
Configure a secure OpenTofu state backend on Azure Blob Storage with blob versioning, lease-based locking, and RBAC-scoped access.
More OpenTofu prompts & error guides
Browse every OpenTofu 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.