Terraform state mv for refactoring - Mini Project: Build & Apply

Terraform state mv for refactoring

📖 Scenario: You have a Terraform project managing cloud resources. You want to rename a resource in your Terraform configuration to improve clarity without destroying and recreating the resource in the cloud.

🎯 Goal: Learn how to use the terraform state mv command to rename a resource in the Terraform state file safely, reflecting the new resource name in your configuration.

📋 What You'll Learn

Create a Terraform configuration with a resource named aws_s3_bucket.old_bucket

Add a variable named new_bucket_name to hold the bucket name

Update the Terraform configuration to use the new resource name aws_s3_bucket.new_bucket

Use terraform state mv command syntax to rename the resource in the state

💡 Why This Matters

🌍 Real World

Renaming resources in Terraform without destroying and recreating them is common when refactoring infrastructure code to improve clarity or organization.

💼 Career

Understanding terraform state mv is essential for cloud engineers and DevOps professionals to safely manage infrastructure changes and avoid downtime.

1

Create initial Terraform resource

Create a Terraform configuration file named main.tf with a resource block for an AWS S3 bucket named old_bucket. Use the resource type aws_s3_bucket and set the bucket name to "my-old-bucket".

Terraform

# Write the resource block for aws_s3_bucket.old_bucket
# Your code here

Need a hint?

Use the resource keyword, resource type aws_s3_bucket, and resource name old_bucket.

2

Add a variable for the new resource name

Add a Terraform variable named new_bucket_name with a default value of "my-old-bucket".

Terraform

resource "aws_s3_bucket" "old_bucket" {
  bucket = "my-old-bucket"
}

# Define variable new_bucket_name with default "my-old-bucket"
# Your code here

Need a hint?

Use the variable block with type = string and default = "my-old-bucket".

3

Update Terraform configuration with new resource name

Update the main.tf file to rename the resource block from old_bucket to new_bucket and set the bucket name to use the variable new_bucket_name.

Terraform

# Rename resource old_bucket to new_bucket and use variable new_bucket_name for bucket
# Your code here

Need a hint?

Change the resource name and use var.new_bucket_name for the bucket attribute.

4

Use terraform state mv command to rename the resource

Write the exact terraform state mv command to rename the resource from aws_s3_bucket.old_bucket to aws_s3_bucket.new_bucket.

Terraform

# Write the terraform state mv command to rename aws_s3_bucket.old_bucket to aws_s3_bucket.new_bucket
# Your code here

Need a hint?

The command format is terraform state mv <old_address> <new_address>.