|
| 1 | +--- |
| 2 | +page_title: Decommission resources |
| 3 | +description: Learn how to decommission infrastructure components while maintaining system integrity and avoiding disruptions through proper planning and automation. |
| 4 | +--- |
| 5 | + |
| 6 | +# Decommission resources |
| 7 | + |
| 8 | +Resource decommissioning is the process of safely removing or deleting infrastructure components, applications, or services that are no longer needed or have reached end-of-life. You should remove unused or obsolete resources such as servers, databases, images, IAM, and other infrastructure components. |
| 9 | + |
| 10 | +When you decommission unused resources, you gain the following benefits: |
| 11 | +- Reduce costs by removing charges associated with unused resources. |
| 12 | +- Minimize security risks by removing outdated or vulnerable resources that bad actors can exploit. |
| 13 | +- Reduce configuration drift by only running necessary resources. |
| 14 | +- Improve audit and compliance by maintaining a smaller infrastructure footprint. |
| 15 | + |
| 16 | +To successfully decommission resources, you need to create a well-defined plan that includes dependency analysis, stakeholder communication, and a gradual removal process. Depending on how your infrastructure implementation is done, either manually or automatically, you may need to adjust your decommissioning approach. |
| 17 | + |
| 18 | +## Find resources to decommission |
| 19 | + |
| 20 | +Before you begin decommissioning resources, you need to identify which resources exist in your environment and determine which ones are candidates for removal. This discovery phase helps you avoid accidentally removing resources that are still in use and ensures you target the right components for decommissioning. |
| 21 | + |
| 22 | +Start by creating an inventory of your infrastructure. Most cloud providers offer resource tagging and billing reports that help identify unused or underutilized resources. Pay particular attention to active resources created for temporary purposes, like testing or proof-of-concepts. |
| 23 | + |
| 24 | +Terraform tracks all infrastructure it manages with state files. You can use the `terraform state list` to see all managed resources and `terraform show` to examine their current configurations. This list of resources will help you identify which resources are still in use and which ones you can decommission. |
| 25 | + |
| 26 | +If you're using HCP Terraform, you can use the [workspace explorer](/terraform/cloud-docs/workspaces/explorer) feature to gain visibility into the resThat ources your organization manages with Terraform. The explorer provides a visual representation of your infrastructure, making it easier to identify resources that you no longer need. |
| 27 | + |
| 28 | +## Create a dependency plan |
| 29 | + |
| 30 | +Your plan should analyze which services, applications, or other resources rely on the components you plan to remove. Your plan will lower the risk of unexpected outages by identifying and addressing dependencies before decommissioning. |
| 31 | + |
| 32 | +If you are using infrastructure as code tools like Terraform, you can use a dependency graph to understand resource relationships. This graph can help you visualize connections between resources and identify potential impacts of removing specific components. |
| 33 | + |
| 34 | +The following command creates a dependency graph of your Terraform resources: |
| 35 | + |
| 36 | +```shell-session |
| 37 | +$ terraform graph -type=plan | dot -Tpng > graph.png |
| 38 | +``` |
| 39 | + |
| 40 | +<Note> |
| 41 | + |
| 42 | +You need to install Graphviz on your system to use the `terraform graph` command and generate visualizations. For more information on installing Graphviz, refer to the [Graphviz installation guide](https://graphviz.org/download/). |
| 43 | + |
| 44 | +</Note> |
| 45 | + |
| 46 | +HashiCorp resources: |
| 47 | + |
| 48 | +- [Terraform graph command](/terraform/cli/commands/graph) |
| 49 | + |
| 50 | +## Create a communication plan |
| 51 | + |
| 52 | +Your plan should outline how you will inform stakeholders about the decommissioning process, including timelines and potential impacts. Effective communication prevents surprises and ensures all affected teams can prepare for the changes. |
| 53 | + |
| 54 | +Start by identifying all stakeholders who might be affected by the decommissioning, including development teams, operations staff, end users, and business owners. Create a notification timeline that provides adequate warning. Your communications should explain what resources you are removing, when the decommissioning will occur, and what actions stakeholders need to take. |
| 55 | + |
| 56 | +## Create backups |
| 57 | + |
| 58 | +Before decommissioning, confirm that you have backups of any critical data or configurations associated with the resources you are removing. Backups provide a safety net in case you need to roll back changes. |
| 59 | + |
| 60 | +You may want to back up the following resources: |
| 61 | +- Servers in the form of machine images |
| 62 | +- Database snapshots |
| 63 | +- Configuration files |
| 64 | +- Metadata |
| 65 | + |
| 66 | +Since Terraform uses infrastructure as code to manage resources, you can redeploy resources that you have previously decommissioned by reapplying your Terraform configuration. This capability allows you to recover resources quickly if needed. |
| 67 | + |
| 68 | +For example, if you backed up a server, you can also redeploy it by updating the AMI in your Terraform with the backed-up AMI ID. In the following example, you can change the `ami` attribute to the ID of your backed-up AMI: |
| 69 | + |
| 70 | +```hcl |
| 71 | +resource "aws_instance" "example" { |
| 72 | + ami = "ami-0c55b159cbfafe1f0" |
| 73 | + instance_type = "t2.micro" |
| 74 | +} |
| 75 | +``` |
| 76 | + |
| 77 | +You can also use Terraform to create [AWS EBS snapshots](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ebs_snapshot) before decommissioning instances. The following example creates an EBS snapshot of the root volume of an EC2 instance: |
| 78 | + |
| 79 | +```hcl |
| 80 | +resource "aws_ebs_volume" "example" { |
| 81 | + availability_zone = "us-west-2a" |
| 82 | + size = 40 |
| 83 | +
|
| 84 | + tags = { |
| 85 | + Name = "HelloWorld" |
| 86 | + } |
| 87 | +} |
| 88 | +
|
| 89 | +resource "aws_ebs_snapshot" "example_snapshot" { |
| 90 | + volume_id = aws_ebs_volume.example.id |
| 91 | +
|
| 92 | + tags = { |
| 93 | + Name = "HelloWorld_snap" |
| 94 | + } |
| 95 | +} |
| 96 | +``` |
| 97 | + |
| 98 | +## Gradually remove resources |
| 99 | + |
| 100 | +Implement a phased approach to removing resources instead of doing it all at once. Start by redirecting traffic away from the resource, and monitor user traffic to ensure you don't negatively impact users. |
| 101 | + |
| 102 | +You can use `terraform plan` to preview the changes that will occur when you remove resources from your configuration. This command helps you understand the impact of your changes before applying them. |
| 103 | + |
| 104 | +You can also set safeguards so you only decommission resources when you are ready. You can use Terraform's `lifecycle` block with `prevent_destroy = true` to prevent accidental deletion of critical resources. The [lifecycle](/terraform/language/meta-arguments#lifecycle) setting ensures that you won't destroy resources unless you explicitly remove the `prevent_destroy` attribute. |
| 105 | + |
| 106 | +```hcl |
| 107 | +resource "aws_instance" "example" { |
| 108 | + ami = "ami-0c55b159cbfafe1f0" |
| 109 | + instance_type = "t2.micro" |
| 110 | +} |
| 111 | +
|
| 112 | +lifecycle { |
| 113 | + prevent_destroy = true |
| 114 | +} |
| 115 | +``` |
| 116 | + |
| 117 | +Consul can help you gradually remove resources by directing traffic away from services you are decommissioning. You can use Consul's service discovery and health checking features to monitor the status of services and ensure that dependent services are not affected during the decommissioning process. |
| 118 | + |
| 119 | +If you are using orchestration tools like Nomad or Kubernetes, you can use their built-in capabilities to drain workloads before decommissioning nodes gracefully. Nomad provides node drain functionality through the `nomad node drain` command, which prevents new scheduling new allocations on a node while safely migrating existing jobs to other available nodes. The Kubernetes `kubectl drain` command safely removes pods from nodes while respecting Pod Disruption Budgets, which ensure that a minimum number of application replicas remain available throughout the process. |
| 120 | + |
| 121 | +HashiCorp resources: |
| 122 | + |
| 123 | +- Review the [Zero-downtime deployments](/well-architected-framework/define-and-automate-processes/deploy/zero-downtime-deployments) documentation for strategies on how to redirect traffic and disable functions gradually. |
| 124 | +- Learn how to [manage resource lifecycles with Terraform](/terraform/tutorials/state/resource-lifecycle). |
| 125 | +- [Get up and running with Nomad](/nomad/tutorials/get-started) by learning about scheduling, setting up a cluster, and deploying an example job. |
| 126 | +- Learn the [fundamentals of Consul](/consul/tutorials). |
| 127 | + |
| 128 | +## Verify health of infrastructure and applications |
| 129 | + |
| 130 | +After the decommissioning process, verify that the remaining infrastructure and applications are functioning correctly. Monitor system performance and user feedback to ensure that there are no negative impacts. |
| 131 | + |
| 132 | +You should do the following steps after you decomission the resources: |
| 133 | + |
| 134 | +- Validate APIs are functioning. |
| 135 | +- Check application performance. |
| 136 | +- Monitor system logs for errors. |
| 137 | + |
| 138 | +HashiCorp resources: |
| 139 | + |
| 140 | +- [Learn to setup monitoring agents](/well-architected-framework/define-and-automate-processes/monitor/setup-monitoring-agents) and [dashboards and alerts](/well-architected-framework/define-and-automate-processes/monitor/dashboards-alerts). |
| 141 | + |
| 142 | +External resources: |
| 143 | + |
| 144 | +- AWS [Implement a decommissioning process](https://docs.aws.amazon.com/wellarchitected/latest/framework/cost_decomissioning_resources_implement_process.html) |
| 145 | + |
| 146 | +## Next steps |
| 147 | + |
| 148 | +In this section of Lifecycle management, you learned about decommissioning resources, including why you should plan decommissioning and how to safely execute the process. Decommission resources is part of the [Optimize systems](/well-architected-framework/optimize-systems) pillar. |
| 149 | + |
| 150 | +To learn more about infrastructure and resource management, refer to the following resource: |
| 151 | + |
| 152 | +- [Data management](/well-architected-framework/optimize-systems/lifecycle-management/data-management) |
0 commit comments