Backend initialization and migration in Terraform - Mini Project: Build & Apply

Backend initialization and migration

📖 Scenario: You are managing infrastructure using Terraform. You want to set up a backend to store your Terraform state remotely and then migrate your existing local state to this new backend.

🎯 Goal: Configure a Terraform backend using terraform block with backend settings, initialize the backend, and migrate the existing state to the remote backend.

📋 What You'll Learn

Create a Terraform configuration file with a backend block for remote state storage

Add a configuration variable for the backend bucket name

Initialize the Terraform backend with the correct command

Migrate the existing local state to the remote backend

💡 Why This Matters

🌍 Real World

Terraform backends store state remotely to enable team collaboration and prevent state conflicts.

💼 Career

Cloud engineers and DevOps professionals must configure and migrate Terraform backends to manage infrastructure safely and efficiently.

1

Create Terraform backend configuration

Create a Terraform configuration file named main.tf with a terraform block that configures an s3 backend. Use the bucket name my-terraform-state-bucket, region us-west-2, and key state/terraform.tfstate.

Terraform

# Your code here

Need a hint?

Use the terraform block with a nested backend "s3" block. Specify bucket, key, and region exactly as given.

2

Add backend bucket variable

Add a variable named backend_bucket in a file named variables.tf with type string and default value my-terraform-state-bucket.

Terraform

terraform {
  backend "s3" {
    bucket = "my-terraform-state-bucket"
    key    = "state/terraform.tfstate"
    region = "us-west-2"
  }
}

# Your code here

Need a hint?

Define a variable block with name backend_bucket, type string, and default my-terraform-state-bucket.

3

Initialize Terraform backend

Run the Terraform command terraform init in your terminal to initialize the backend configuration and prepare Terraform to use the remote state.

Terraform

# Your code here

Need a hint?

Use the exact command terraform init in your terminal to initialize the backend.

4

Migrate local state to remote backend

Run the Terraform command terraform init -migrate-state in your terminal to migrate your existing local Terraform state to the configured remote backend.

Terraform

# Your code here

Need a hint?

Use the exact command terraform init -migrate-state in your terminal to migrate the state.