Terraform Workspaces to Manage Multiple Environments

Overview

Terraform is an infrastructure as a code tool that allows users to create, manage, and provision cloud infrastructure resources. One of the useful features of Terraform is its workspace functionality. Workspaces enable users to manage multiple infrastructure resources within a single configuration file.

What is a Terraform workspace?

A Terraform workspace is a way to create multiple instances of the same infrastructure in different environments. For example, you may have a development environment, a staging environment, and a production environment. Each environment may require the same infrastructure but with different configurations.

Here are some of the benefits of using Terraform workspaces:

1. Organize resources

Workspaces allow you to organize your infrastructure resources into logical groups. For example, you can create separate workspaces for development, testing, and production environments. This helps to keep your resources organized and makes it easier to manage them.

2. Reduce errors

With Terraform workspaces, you can avoid errors caused by sharing resources across different environments. For example, if you accidentally delete a resource in one workspace, it won’t affect resources in other workspaces.

3. Share infrastructure code

You can share your infrastructure code across different environments, reducing the need to maintain a separate set of code for each environment.

4. Improve collaboration

Workspaces can be used to collaborate with other members of your team. Each team member can work on their workspace without interfering with the work of others.

5. Flexibility

Using workspaces allows you to create and manage multiple environments with the same infrastructure codebase. You can easily create new environments or delete existing ones as needed.

How to create a Workspace in Terraform?

To create a new workspace in Terraform, use the command

For example, to create a new workspace called development, run the following command:

You can switch to the new workspace using the command

For example, to switch to the development workspace, run the following command:

When you switch to a new workspace, Terraform creates a new state file to store the state of the resources for that workspace.

Managing Workspace-Specific Resources

To manage workspace-specific resources in Terraform, you can use terraform.workspace variable. This variable contains the name of the current workspace and can be used in your Terraform code to create or delete resources based on the workspace conditionally.

For example, you can create a conditional block that creates a resource only in the development workspace:

In this example, the aws_instance resource is created only if the current workspace is in development. If the current workspace is not developed, the resource is not created.

Using Terraform workspaces

Once you have created a workspace, you can use it to manage your infrastructure in that environment. For example, you can use the terraform plan command to see what changes will be made to the infrastructure for this workspace:

This command will show you the changes that will be made to the infrastructure for the current workspace.

You can then use the terraform apply command to apply the changes:

This command will apply the changes to the infrastructure for the current workspace. You can also apply using a specific var file

Conclusion

Terraform workspaces are a powerful tool for managing multiple infrastructure resources within a single configuration file. You can organize resources, reduce errors, share infrastructure code, and improve collaboration using workspaces.

About CloudThat