Clarify background on unique names in TFC

This commit is contained in:
Judith Malnick 2021-12-08 09:45:18 -08:00 committed by GitHub
parent 310368d464
commit 5897c9590c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 6 deletions

View File

@ -22,13 +22,14 @@ backend](/docs/language/settings/backends/index.html)), Terraform will ask your
that state to Terraform Cloud. This process is interactive and self-documenting, and resembles that state to Terraform Cloud. This process is interactive and self-documenting, and resembles
moving between state backends. moving between state backends.
You may also be prompted to rename your workspaces during the migration, to either give a name to Terraform may also prompt you to rename your workspaces during the migration, to either give a name to
the unnamed `default` workspace (Terraform Cloud requires all workspaces to have a name) or give the unnamed `default` workspace (Terraform Cloud requires all workspaces to have a name) or give
your workspace names more contextual information. Unlike typical Terraform workspaces representing your workspace names more contextual information. Unlike Terraform CLI-only workspaces, which represent
an environment associated with a particular configuration (e.g. production, staging, development), multiple environments associated with the same configuration (e.g. production, staging, development),
Terraform Cloud workspaces are named uniquely across all configurations used within an organization. Terraform Cloud workspaces can represent totally independent configurations, and must have unique names within the Terraform Cloud organization.
Because of this, you'll be given an opportunity to rename the working directory's workspaces
according to a pattern relative to their existing names. A typical strategy to start with is Because of this, Terraform will prompt you to rename the working directory's workspaces
according to a pattern relative to their existing names, which can indicate the fact that these specific workspaces share configuration. A typical strategy to start with is
`<COMPONENT>-<ENVIRONMENT>-<REGION>` (e.g. `networking-prod-us-east`, `<COMPONENT>-<ENVIRONMENT>-<REGION>` (e.g. `networking-prod-us-east`,
`networking-staging-us-east`). For more information on workspace naming, see [Workspace `networking-staging-us-east`). For more information on workspace naming, see [Workspace
Naming](/docs/cloud/workspaces/naming.html) in the Terraform Cloud documentation. Naming](/docs/cloud/workspaces/naming.html) in the Terraform Cloud documentation.