Terraform workspaces

Terraform workspaces (Mar 2017, previously known as State Environments ) allows to have multiple state files in the same working directory to manage multiple distinct sets of infrastructure resources.

• https://www.terraform.io/language/state/workspaces

Certain backends support multiple named workspaces allowing multiple states to be associated with a single configuration.

• terraform.tfstate.d

• VCS connections https://www.terraform.io/cloud-docs/workspaces/settings/vcs

• terraform workspace -help

• Supported backends: AzureRM, Consul, COS, etcdv3, GCS, Kubernetes, Local, Manta, OSS, Postgres, Remote, S3, Swift

Usage scenarios

• To create a parallel, distinct copy of a set of infrastructure in order to test a set of changes before modifying the main production infrastructure.
• Non-default workspaces are often related to feature branches in version control.

Commands

• terraform workspace new MY_NEW_WORKSPACE
• terraform workspace select
• terraform workspace list
• terraform workspace show
• terraform workspace delete
• terraform workspace --help

Related

• ${terraform.workspace}
• Terraform provider: dns
• Terragrunt

See also

• Terraform workspaces, terraform workspace, [new | select | list | delete | show] -help, Terraform Enterprise (TFE) workspaces
• Terraform Workspaces