Saturday, January 20, 2024

Terraform Worskpace: Configuration and Best Practices (CI/CD Series)

Terraform Workspaces provide a robust solution for managing distinct sets of infrastructure resources within a single configuration, offering flexibility and efficiency in handling various environments. In this comprehensive guide, we will walk you through the process of creating and leveraging Terraform Workspaces to enhance your infrastructure management capabilities.

Step 1: Setting Up Your Terraform Environment

Before delving into Workspaces, ensure Terraform is installed on your system. Download it from the official Terraform website and follow the installation instructions based on your operating system.

Step 2: Initializing a Basic Terraform Configuration

Begin by creating a basic Terraform configuration in a new directory. This can be as simple as defining a provider and a single resource. For instance:

provider "aws" {

  region = "ap-southeast-3"


resource "aws_instance" "example" {

  ami           = "ami-0c55b159cbfafe1f0"

  instance_type = "t2.micro"


Step 3: Understanding and Creating Workspaces

By default, Terraform operates in a workspace named "default." To create a new workspace, execute the command:

terraform workspace new development

This command creates and switches to a workspace named "development."

Step 4: Managing Resources in Different Workspaces

Each workspace operates in isolation, ensuring changes in one workspace do not impact others. Switch between workspaces using the command:

terraform workspace select development

Adjust your Terraform configuration to behave differently based on the workspace. For example:

variable "instance_type" {

  default = "t2.micro"


resource "aws_instance" "example" {

  ami           = "ami-0c55b159cbfafe1f0"

  instance_type = terraform.workspace == "development" ? "t2.small" : var.instance_type


Step 5: Applying Configuration Changes in Workspaces

To apply your configuration in the selected workspace, run:

terraform apply

This will provision resources according to the workspace-specific configuration.

Step 6: Best Practices for Workspace Usage

Utilize workspaces for managing different environments, but refrain from using them for entirely different configurations.

Maintain consistency in the base configuration across workspaces and introduce differences through variables.

Always verify the active workspace before applying changes to prevent unintended modifications.


Terraform Workspaces empower users to efficiently manage multiple environments under a unified configuration. By following this guide, you can seamlessly create and leverage workspaces, ensuring a scalable and maintainable infrastructure setup. While workspaces are a valuable tool, remember to explore other features within the Terraform ecosystem to fully unlock its potential in infrastructure management.

Source Documentation: Terraform Official Documentation


Post a Comment