Backend initialization and migration in Terraform - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is the purpose of Terraform backend initialization?

Backend initialization configures where Terraform stores its state files, enabling collaboration and state locking to prevent conflicts.

beginner

What command do you use to initialize a Terraform backend?

You use terraform init to initialize the backend and prepare the working directory for Terraform operations.

intermediate

Why would you migrate a Terraform backend?

To move the Terraform state from one backend to another, for example, from local files to a remote storage for better collaboration and security.

intermediate

What is the command to migrate Terraform state to a new backend?

Run terraform init -migrate-state to migrate the existing state to the newly configured backend safely.

advanced

What happens if you change backend configuration without migrating state?

Terraform will not automatically move your state, which can cause errors or loss of state tracking. You must migrate state explicitly.

Which command initializes the Terraform backend?

A terraform init

B terraform apply

C terraform plan

D terraform migrate

terraform init sets up the backend and prepares Terraform for use.

What does the -migrate-state flag do during terraform init?

A Validates the Terraform configuration

B Deletes the existing state

C Creates a new state file locally

D Moves state to the new backend

It safely migrates the existing state to the newly configured backend.

Why is backend migration important?

A To change where state is stored for collaboration

B To speed up Terraform plan

C To delete old infrastructure

D To update Terraform version

Migrating backend changes where Terraform stores state, enabling teamwork and security.

What happens if you change backend config but skip migration?

A Terraform automatically migrates state

B Terraform loses track of existing resources

C Terraform throws an error or uses empty state

D Terraform deletes all resources

Terraform will not find the existing state and may error or start fresh, risking resource mismanagement.

Which backend type is commonly used for remote state storage in Terraform?

A Local file

B S3 bucket

C Docker container

D Kubernetes pod

S3 buckets are popular for remote state storage due to durability and access control.

Explain the steps to migrate Terraform state from a local backend to a remote backend.

Think about changing config and using terraform init carefully.

Describe why backend initialization is critical before running Terraform commands.

Consider what happens if Terraform doesn't know where to save its progress.

Practice

1. What is the main purpose of initializing a backend in Terraform?

easy

A. To write Terraform code faster

B. To tell Terraform where to save its state file

C. To create virtual machines automatically

D. To delete old infrastructure resources

Solution

1. Step 1: Understand backend role

   The backend in Terraform stores the state file, which tracks resources.

2. Step 2: Initialization purpose

   Initializing the backend tells Terraform where to save and read this state file.

3. Final Answer:

   To tell Terraform where to save its state file -> Option B

4. Quick Check:

   Backend initialization = state location setup [OK]

Hint: Backend init sets state file location [OK]

Common Mistakes:

• Confusing backend with resource creation
• Thinking backend speeds up code writing
• Assuming backend deletes resources

2. Which Terraform command initializes the backend configuration?

easy

A. terraform apply

B. terraform plan

C. terraform init

D. terraform destroy

Solution

1. Step 1: Identify initialization command

   Terraform uses terraform init to initialize working directory and backend.

2. Step 2: Differentiate from other commands

   terraform apply applies changes, plan previews, destroy deletes resources.

3. Final Answer:

   terraform init -> Option C

4. Quick Check:

   Init command = terraform init [OK]

Hint: Use 'terraform init' to set up backend [OK]

Common Mistakes:

• Using 'terraform apply' to initialize backend
• Confusing 'plan' with initialization
• Running 'terraform destroy' by mistake

3. Given this Terraform backend block:

terraform {
  backend "s3" {
    bucket = "mybucket"
    key    = "state.tfstate"
    region = "us-east-1"
  }
}

What happens when you run terraform init for the first time?

medium

A. Terraform creates the S3 bucket automatically

B. Terraform applies the infrastructure changes immediately

C. Terraform deletes any existing state files locally

D. Terraform downloads provider plugins and configures remote state in the S3 bucket

Solution

1. Step 1: Understand backend init behavior

   On first terraform init, Terraform downloads required plugins and sets up remote state backend.

2. Step 2: Check resource creation

   Terraform does NOT create the S3 bucket automatically; it expects it to exist.

3. Final Answer:

   Terraform downloads provider plugins and configures remote state in the S3 bucket -> Option D

4. Quick Check:

   Init downloads plugins + configures backend [OK]

Hint: Init downloads plugins, configures backend; no resource creation [OK]

Common Mistakes:

• Assuming S3 bucket is created automatically
• Thinking init deletes local state files
• Confusing init with apply

4. You changed your Terraform backend from local to remote S3 but forgot to migrate the state. What error will you likely see when running terraform init?

medium

A. Error: No existing state found in the remote backend

B. Error: Backend configuration block missing

C. Error: State file already exists locally and cannot be overwritten

D. Error: Terraform version mismatch

Solution

1. Step 1: Understand backend migration

   When switching backend types, Terraform expects existing state in the new backend or migration.

2. Step 2: Identify error on missing remote state

   If state is not migrated, terraform init reports no existing state found remotely.

3. Final Answer:

   Error: No existing state found in the remote backend -> Option A

4. Quick Check:

   Missing remote state = no existing state error [OK]

Hint: Missing migrated state causes 'no existing state' error [OK]

Common Mistakes:

• Expecting backend config missing error
• Confusing local state overwrite error
• Blaming Terraform version mismatch

5. You want to migrate your Terraform state from a local backend to an Azure Blob Storage backend. Which sequence of steps is correct to safely migrate the state?

hard

A. 1. Update backend block to Azure Blob Storage
2. Run 'terraform init' with '-migrate-state'
3. Verify state in Azure
4. Continue with 'terraform apply'

B. 1. Delete local state file
2. Update backend block to Azure Blob Storage
3. Run 'terraform apply'
4. Run 'terraform init'

C. 1. Run 'terraform apply'
2. Update backend block to Azure Blob Storage
3. Run 'terraform init'
4. Verify state in Azure

D. 1. Update backend block to Azure Blob Storage
2. Run 'terraform init' without flags
3. Manually copy state file to Azure
4. Run 'terraform apply'

Solution

1. Step 1: Update backend block to new backend

   Change Terraform config to use Azure Blob Storage backend.

2. Step 2: Run 'terraform init' with migration flag

   Use terraform init -migrate-state to move existing state safely to new backend.

3. Step 3: Verify state is in Azure

   Check Azure Blob Storage to confirm state file is present.

4. Step 4: Continue normal workflow

   Run terraform apply to manage infrastructure with new backend.

5. Final Answer:

   1. Update backend block to Azure Blob Storage 2. Run 'terraform init' with '-migrate-state' 3. Verify state in Azure 4. Continue with 'terraform apply' -> Option A

6. Quick Check:

   Update backend + init migrate + verify + apply [OK]

Hint: Use 'terraform init -migrate-state' after backend update [OK]

Common Mistakes:

• Deleting local state before migration
• Running apply before init
• Manually copying state file instead of migrating