Skip to main content
In this article, we explore troubleshooting steps when Terraform apply hangs and learn how to safely back up and restore your Terraform state file. These strategies ensure your infrastructure remains stable even when encountering unexpected issues.

​
Understanding the Problem

Terraform apply may hang for various reasons. The interviewer may be testing your experience with edge cases involving Terraform state files. Common causes include:
  1. Connection Interruptions: Disruptions between your cloud provider or local file system (e.g., your laptop) can pause the process.
  2. Lack of State Locking: Without a proper locking mechanism, multiple simultaneous writes can lead to conflicts.
  3. Cloud Resource Issues: Problems with your cloud provider (AWS, Google Cloud, or Azure) may hinder progress.
If Terraform apply shows no progress for several minutes, it could indicate that the state file is affected.

​
Steps to Debug and Recover

​
1. Back Up the Current State

Before taking further action, open a new terminal (referred to as Terminal Two) and back up your current state file using: 
terraform state pull
This command retrieves the latest state file (usually named terraform.tfstate) and creates an immediate backup, ensuring you have a recovery point if issues arise.

​
2. Cancel the Hung Process

Switch to the terminal where Terraform apply is running (referred to as Terminal One) and cancel the process by pressing Ctrl+C.
Interrupting Terraform apply may leave your state file in an inconsistent or corrupted state. Proceed with caution and ensure you have backed up your state file.

​
3. Re-run Terraform Apply

Once you have canceled the process, attempt to run Terraform apply again: 
terraform apply
If the state file is intact, the process should complete successfully. If you encounter errors related to the state file, restore the backup and retry the operation.

​
4. Modularize Your Configuration

To reduce the risk of state file conflicts, consider breaking your configuration into smaller modules with separate state files. This modular approach not only minimizes potential issues but also adds flexibility to manage your infrastructure.

​
Summary

In summary, a hung Terraform apply can result from connectivity issues, missing state locking, or underlying cloud resource problems. To safeguard your infrastructure, follow these steps:
  • Back up your state file using terraform state pull.
  • Cancel the hung process by pressing Ctrl+C.
  • Re-run Terraform apply, and if necessary, restore from backup.
  • Modularize your configuration by using separate state files for different resources.
By implementing these practices, you can effectively recover from a hung Terraform apply operation and maintain the integrity of your infrastructure management process.

Watch Video