{"id":47478,"date":"2024-11-26T16:12:58","date_gmt":"2024-11-26T16:12:58","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=47478"},"modified":"2024-11-26T16:12:58","modified_gmt":"2024-11-26T16:12:58","slug":"terraform-tutorials-step-by-step-tutorial-for-using-the-removed-block","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/terraform-tutorials-step-by-step-tutorial-for-using-the-removed-block\/","title":{"rendered":"Terraform Tutorials: Step-by-Step Tutorial for Using the removed Block"},"content":{"rendered":"\n

Step-by-Step Tutorial for Using the removed<\/code> Block in Terraform<\/strong><\/h3>\n\n\n\n

The removed<\/code> block in Terraform (introduced in version 1.7<\/strong>) provides a safe way to remove resources from the Terraform state without destroying them in the real infrastructure. This is especially useful when you want Terraform to stop managing specific resources but retain their existence in your cloud environment.<\/p>\n\n\n\n

\n\n\n\n

What is the removed<\/code> Block?<\/strong><\/h3>\n\n\n\n

The removed<\/code> block explicitly informs Terraform that certain resources are no longer managed by the configuration. During terraform apply<\/code>, Terraform removes these resources from the state without attempting to delete them in the actual infrastructure.<\/p>\n\n\n

removed {\n  from<\/span> = aws_instance.example\n\n  lifecycle {\n    destroy = false<\/span>\n  }\n}<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
<\/p>\n\n\n\n
\n\n\n\n
When to Use the removed<\/code> Block<\/strong><\/h3>\n\n\n\n
Here are 10 scenarios<\/strong> where the removed<\/code> block is useful:<\/p>\n\n\n\n
    \n
  1. Legacy Resource Cleanup<\/strong>: Resources created with Terraform are now managed manually or by another tool.<\/li>\n\n\n\n
  2. Split Configurations<\/strong>: Moving resources from one Terraform workspace\/module to another without impacting the infrastructure.<\/li>\n\n\n\n
  3. Orphaned State Entries<\/strong>: Removing unused state entries that no longer exist in real infrastructure.<\/li>\n\n\n\n
  4. Migration to a New Tool<\/strong>: Switching from Terraform to another IaC tool while leaving resources intact.<\/li>\n\n\n\n
  5. Third-Party Resource Management<\/strong>: Transitioning resource management to another team or tool.<\/li>\n\n\n\n
  6. Failed Deletions<\/strong>: When a resource deletion fails but you no longer want Terraform to track it.<\/li>\n\n\n\n
  7. Resource Lock-In Prevention<\/strong>: Detaching resources that must remain after Terraform’s scope changes.<\/li>\n\n\n\n
  8. State File Size Optimization<\/strong>: Removing large numbers of unmanaged resources from the state file to improve performance.<\/li>\n\n\n\n
  9. Custom Manual Adjustments<\/strong>: Detaching resources that are being modified outside Terraform’s scope.<\/li>\n\n\n\n
  10. Testing and Development<\/strong>: Temporarily removing a resource for testing purposes without actually deleting it.<\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n
    How to Use the removed<\/code> Block<\/strong><\/h3>\n\n\n\n
    Step-by-Step Process<\/strong><\/h4>\n\n\n\n
      \n
    1. Identify the Resource to Remove<\/strong>
      Use terraform state list<\/code> to find the resource in the Terraform state that you want to stop managing. terraform state list<\/code><\/li>\n\n\n\n
    2. Add the removed<\/code> Block<\/strong>
      Add a removed<\/code> block to your configuration for the resource(s) you want to remove. removed { from = aws_instance.example }<\/code><\/li>\n\n\n\n
    3. Run terraform plan<\/code><\/strong>
      Terraform will show that the specified resource will be removed from the state. terraform plan<\/code><\/li>\n\n\n\n
    4. Apply the Changes<\/strong>
      Execute terraform apply<\/code> to remove the resource from the state file. terraform apply<\/code><\/li>\n\n\n\n
    5. Clean Up the Configuration<\/strong>
      After removing the resource from the state, you can remove the removed<\/code> block if it is no longer needed.<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n
      5 Code Examples of the removed<\/code> Block<\/strong><\/h3>\n\n\n\n
      Example 1: Removing a Single Resource<\/strong><\/h4>\n\n\n
      # Step 1: Identify the resource<\/span>\nresource \"aws_instance\"<\/span> \"example\"<\/span> {\n  ami           = \"ami-12345678\"<\/span>\n  instance_type = \"t2.micro\"<\/span>\n}\n\n# Step 2: Replace the resource block with the removed block<\/span>\nremoved {\n  from = aws_instance.example\n}\n\n# Step 3: Run Terraform commands<\/span>\nterraform plan\nterraform apply\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Example 2: Removing Multiple Resources<\/strong><\/h4>\n\n\n
      # Step 1: Define multiple resources (before removal)<\/span>\nresource \"aws_instance\"<\/span> \"web\"<\/span> {\n  ami           = \"ami-12345678\"<\/span>\n  instance_type = \"t2.micro\"<\/span>\n}\n\nresource \"aws_instance\"<\/span> \"db\"<\/span> {\n  ami           = \"ami-87654321\"<\/span>\n  instance_type = \"t3.micro\"<\/span>\n}\n\n# Step 2: Add removed blocks for both resources<\/span>\nremoved {\n  from = aws_instance.web\n}\n\nremoved {\n  from = aws_instance.db\n}\n\n# Step 3: Run Terraform commands<\/span>\nterraform plan\nterraform apply\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Example 3: Removing Dynamically Created Resources<\/strong><\/h4>\n\n\n
      # Step 1: Original resource definition<\/span>\nresource \"aws_s3_bucket\"<\/span> \"example\"<\/span> {\n  for_each = toset([\"bucket1\"<\/span>, \"bucket2\"<\/span>, \"bucket3\"<\/span>])\n  bucket   = each.key\n}\n\n# Step 2: Replace the resource block with removed blocks<\/span>\nremoved {\n  from = aws_s3_bucket.example[\"bucket1\"<\/span>]\n}\n\nremoved {\n  from = aws_s3_bucket.example[\"bucket2\"<\/span>]\n}\n\nremoved {\n  from = aws_s3_bucket.example[\"bucket3\"<\/span>]\n}\n\n# Step 3: Run Terraform commands<\/span>\nterraform plan\nterraform apply\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Example 4: Transitioning to a New Module<\/strong><\/h4>\n\n\n
      # Step 1: Original resource definition<\/span>\nresource \"aws_vpc\"<\/span> \"main\"<\/span> {\n  cidr_block = \"10.0.0.0\/16\"<\/span>\n}\n\n# Step 2: Move VPC definition to a new module<\/span>\nmodule \"network\"<\/span> {\n  source     = \".\/modules\/network\"<\/span>\n  cidr_block = \"10.0.0.0\/16\"<\/span>\n}\n\n# Step 3: Use the removed block for the old VPC definition<\/span>\nremoved {\n  from = aws_vpc.main\n}\n\n# Step 4: Run Terraform commands<\/span>\nterraform plan\nterraform apply\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Example 5: Removing Orphaned State Entries<\/strong><\/h4>\n\n\n
      # Step 1: Identify orphaned state entries<\/span>\n# List resources in the state<\/span>\nterraform state list<\/span>\n\n# Step 2: Add a removed block for the orphaned resource<\/span>\nremoved {\n  from = aws_security_group.orphaned\n}\n\n# Step 3: Run Terraform commands<\/span>\nterraform plan\nterraform apply\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Best Practices for Using the removed<\/code> Block<\/strong><\/h3>\n\n\n\n
        \n
      1. Backup the State File<\/strong>: Always back up your terraform.tfstate<\/code> file before making changes. cp terraform.tfstate terraform.tfstate.bak<\/code><\/li>\n\n\n\n
      2. Document Changes<\/strong>: Clearly document why a resource was removed to ensure future maintainability.<\/li>\n\n\n\n
      3. Test in Non-Production Environments<\/strong>: Verify the behavior of the removed<\/code> block in a staging environment before applying it to production.<\/li>\n\n\n\n
      4. Review Impact with plan<\/code><\/strong>: Always run terraform plan<\/code> to validate that no unintended changes will occur.<\/li>\n\n\n\n
      5. Remove the removed<\/code> Block After Use<\/strong>: Once the resource is removed from the state, delete the removed<\/code> block to avoid confusion in future updates.<\/li>\n<\/ol>\n\n\n\n
        \n","protected":false},"excerpt":{"rendered":"
        Step-by-Step Tutorial for Using the removed Block in Terraform The removed block in Terraform (introduced in version 1.7) provides a safe way to remove resources from the Terraform state without… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[2],"tags":[],"class_list":["post-47478","post","type-post","status-publish","format-standard","hentry","category-uncategorised"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/47478","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=47478"}],"version-history":[{"count":1,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/47478\/revisions"}],"predecessor-version":[{"id":47479,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/47478\/revisions\/47479"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=47478"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=47478"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=47478"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}