Terraform state pull and push - Cheat Sheet & Quick Revision

Recall & Review

beginner

What does the terraform state pull command do?

It downloads the current Terraform state file from the remote backend and outputs it locally. This lets you see the exact state Terraform is tracking.

beginner

What is the purpose of terraform state push?

It uploads a local Terraform state file to the remote backend, replacing the existing state. This is useful to fix or update the remote state manually.

intermediate

Why should you be careful when using terraform state push?

Because it overwrites the remote state file, which can cause conflicts or loss of changes if done incorrectly. Always ensure the state file is valid and up to date.

beginner

How does Terraform use the state file during deployments?

Terraform uses the state file to track resources it manages. It compares the state to your configuration to know what to create, update, or delete.

intermediate

When might you need to manually pull and push Terraform state?

When fixing state corruption, migrating state between backends, or recovering from errors where the remote state is out of sync with local files.

What does terraform state pull do?

A Downloads the current remote state file

B Uploads a local state file to remote

C Deletes the remote state file

D Initializes the Terraform backend

terraform state pull downloads the remote state file so you can view or save it locally.

Which command uploads a local state file to the remote backend?

A terraform state pull

B terraform apply

C terraform init

D terraform state push

terraform state push uploads your local state file to replace the remote state.

Why should you avoid frequent use of terraform state push?

A It can overwrite remote state causing conflicts

B It deletes all resources

C It resets your Terraform configuration

D It only works with local backends

Pushing state overwrites remote state and can cause conflicts or loss if not done carefully.

What is stored inside the Terraform state file?

A Terraform configuration code

B Resource metadata and current infrastructure info

C User credentials

D Cloud provider billing info

The state file stores metadata about resources Terraform manages and their current status.

When is it appropriate to manually pull and push Terraform state?

A When creating new resources

B Every time you run <code>terraform apply</code>

C When fixing state corruption or migrating state

D When deleting Terraform configuration files

Manual pull and push are used for recovery or migration, not routine operations.

Explain the roles of terraform state pull and terraform state push in managing Terraform state.

Think about how Terraform keeps track of resources remotely and locally.

Describe why careful handling of Terraform state files is important during infrastructure management.

Consider what happens if Terraform's view of resources is wrong.

Practice

1. What does the terraform state pull command do?

easy

A. Deletes the current Terraform state from the backend

B. Uploads a local state file to the remote backend

C. Initializes the Terraform working directory

D. Downloads the current Terraform state file to your local machine

Solution

1. Step 1: Understand the purpose of state pull

   The terraform state pull command fetches the current state file from the remote backend and saves it locally.

2. Step 2: Differentiate from push and other commands

   Unlike push, which uploads a local state, pull only downloads the state. It does not delete or initialize anything.

3. Final Answer:

   Downloads the current Terraform state file to your local machine -> Option D

4. Quick Check:

   Pull = Download state [OK]

Hint: Pull means download state from cloud to local [OK]

Common Mistakes:

• Confusing pull with push (upload)
• Thinking pull deletes state
• Mixing pull with terraform init

2. Which is the correct syntax to upload a local state file named my.tfstate to the remote backend?

easy

A. terraform state pull my.tfstate

B. terraform state push my.tfstate

C. terraform push state my.tfstate

D. terraform upload state my.tfstate

Solution

1. Step 1: Identify the correct command for uploading state

   The command to upload a local state file to the remote backend is terraform state push followed by the filename.

2. Step 2: Verify syntax correctness

   Options C and D use invalid command structures. terraform state pull my.tfstate is for downloading, not uploading.

3. Final Answer:

   terraform state push my.tfstate -> Option B

4. Quick Check:

   Push = upload state file [OK]

Hint: Push uploads local state; syntax: terraform state push filename [OK]

Common Mistakes:

• Using pull instead of push
• Incorrect command order
• Using terraform upload which doesn't exist

3. Given you run terraform state pull and save the output to local.tfstate, what will terraform state push local.tfstate do next?

medium

A. Initialize the Terraform backend

B. Download the remote state again and overwrite local.tfstate

C. Upload the exact state you just downloaded back to the remote backend

D. Delete the remote state file

Solution

1. Step 1: Understand the pull then push sequence

   Pull downloads the current remote state to local. Push uploads a local state file to the remote backend.

2. Step 2: Analyze the effect of pushing the pulled state

   Pushing the same file you pulled will overwrite the remote state with the same content, effectively restoring it.

3. Final Answer:

   Upload the exact state you just downloaded back to the remote backend -> Option C

4. Quick Check:

   Pull then push = download then upload same state [OK]

Hint: Push after pull uploads the same state back [OK]

Common Mistakes:

• Thinking push downloads state
• Assuming push deletes state
• Confusing push with init

4. You tried to run terraform state push without specifying a file. What error will you most likely see?

medium

A. Error: Missing required argument: filename

B. State pushed successfully

C. Error: No state file found in current directory

D. Error: Backend not initialized

Solution

1. Step 1: Check command requirements

   The terraform state push command requires a filename argument to specify which local state file to upload.

2. Step 2: Identify error when argument is missing

   Without the filename, Terraform will return an error about the missing required argument.

3. Final Answer:

   Error: Missing required argument: filename -> Option A

4. Quick Check:

   Push needs filename argument [OK]

Hint: Push command needs a file name argument [OK]

Common Mistakes:

• Running push without filename
• Expecting push to work without arguments
• Confusing missing file error with backend init error

5. You have a corrupted local state file and want to fix your remote state safely. Which sequence of commands should you use?

hard

A. Run terraform state pull to download the remote state, fix the local file, then terraform state push to upload it

B. Run terraform state push first, then terraform state pull

C. Delete the remote state manually, then run terraform init

D. Run terraform refresh to fix the state automatically

Solution

1. Step 1: Download the current remote state safely

   Use terraform state pull to get the latest remote state to your local machine.

2. Step 2: Fix the corrupted local state file

   Edit or repair the downloaded state file carefully to correct corruption.

3. Step 3: Upload the fixed state back to remote

   Use terraform state push to update the remote backend with the corrected state file.

4. Final Answer:

   Run terraform state pull to download the remote state, fix the local file, then terraform state push to upload it -> Option A

5. Quick Check:

   Pull, fix, then push = safe state repair [OK]

Hint: Pull remote state, fix locally, then push back [OK]

Common Mistakes:

• Pushing corrupted state first
• Deleting remote state manually
• Expecting terraform refresh to fix state file