bashANYterraformdebuglogstrace
bash
export TF_LOG=TRACETurn on maximum logging detail for hard-to-diagnose issues.
Terraform Troubleshooting and Migration Cheat Sheet
Commands and patterns for debugging, upgrades, migration, and state repair in Terraform.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Debugging
Logs, provider issues, and plan inspection.
bashANYterraformdebuglogs
bash
export TF_LOG=DEBUG && export TF_LOG_PATH=terraform-debug.logCapture debug logs into a file for later analysis.
bashANYterraformprovidersschemajson
bash
terraform providers schema -json > providers-schema.jsonDump provider schemas for automation or debugging tools.
bashANYterraformplanexit-codeci
bash
terraform plan -detailed-exitcodeReturn 0 for no changes, 2 for changes, 1 for errors; useful in CI.
Upgrade and Migration
Version-locking and migration-related commands.
Legacy 0.13 upgrade helper
Legacy helper command that updated provider source declarations in Terraform 0.13.
bashANYterraformupgradelegacy
bash
terraform 0.13upgradeLegacy helper command that updated provider source declarations in Terraform 0.13.
Upgrade after version changes
Refresh provider selections and lock file after changing constraints.
bashANYterraformupgradeproviderslock
bash
terraform init -upgrade && terraform providers lock -platform=linux_amd64 -platform=darwin_arm64Refresh provider selections and lock file after changing constraints.
hclANYterraformmovedmodules
hcl
moved {
from = module.network.aws_subnet.private["a"]
to = module.vpc.aws_subnet.private["a"]
}Preserve state when refactoring module paths or names.
State Repair
State surgery patterns for emergencies and refactors.
bashANYterraformstatemodule
bash
terraform state show module.vpc.aws_vpc.thisInspect one resource nested inside a module.
bashANYterraformstatemvmodules
bash
terraform state mv module.old.aws_s3_bucket.logs module.new.aws_s3_bucket.logsMove a tracked object between module addresses.
bashANYterraformstatermcount
bash
terraform state rm aws_instance.web[0]Remove a single indexed or keyed instance from state.
Drift and Recovery
Recover from drift, failed runs, and manual changes.
bashANYterraformdriftrefresh-only
bash
terraform plan -refresh-onlyRefresh state from real infrastructure without proposing config changes.
bashANYterraformdriftrefresh-onlyapply
bash
terraform apply -refresh-only -auto-approvePersist refreshed state after infrastructure drift detection.
Import after state loss
Rebuild Terraform state associations after state loss or partial migration.
bashANYterraformimportrecovery
bash
terraform import aws_db_instance.main my-db-instance-idRebuild Terraform state associations after state loss or partial migration.
More in Terraform
Terraform HCP Remote and CI Cheat Sheet
Commands and snippets for HCP Terraform remote runs, CLI auth, automation, and CI-friendly usage.
Terraform Language Patterns Cheat Sheet
High-value HCL patterns for variables, locals, outputs, loops, conditionals, dynamic blocks, and data shaping.
Terraform Modules and Providers Cheat Sheet
Commands and snippets for modules, providers, version constraints, registry access, and dependency management.
Terraform Workspaces and State Cheat Sheet
Manage Terraform CLI workspaces, local and remote state, imports, and state surgery commands.
Terraform CLI Cheat Sheet
Core Terraform CLI commands for init, plan, apply, state, output, variables, workspaces, and automation.
Recommended next
kubeadm Cheat Sheet
KUBERNETES
Bootstrap, join, cert, kubeconfig, reset, phase, image, and upgrade commands for kubeadm-managed clusters.
Kubernetes JSONPath and Kustomize Cheat Sheet
KUBERNETES
JSONPath recipes, custom output patterns, jq/yq workflows, and Kustomize commands supported by kubectl.
Kubernetes Troubleshooting Cheat Sheet
KUBERNETES
Debugging, inspection, RBAC checks, rollout failures, node health, and maintenance-oriented kubectl workflows.
Kubernetes Networking, Storage, and Config Cheat Sheet
KUBERNETES
Services, ingress, EndpointSlices, network policies, PVCs, PVs, storage classes, ConfigMaps, Secrets, and nodes.
Kubernetes Workloads Cheat Sheet
KUBERNETES
Deployments, StatefulSets, DaemonSets, Jobs, CronJobs, autoscaling, rollouts, and workload maintenance.
Kubernetes & kubectl Cheat Sheet
KUBERNETES
Comprehensive kubectl commands for contexts, resources, apply flows, creation, deletion, logs, and cluster introspection.