diff --git a/website/docs/cli/cloud/index.mdx b/website/docs/cli/cloud/index.mdx index a8c93cb532c7..2497b06656fa 100644 --- a/website/docs/cli/cloud/index.mdx +++ b/website/docs/cli/cloud/index.mdx @@ -10,7 +10,7 @@ The Terraform CLI integration with HCP Terraform lets you use HCP Terraform and Using HCP Terraform through the command line is called the [CLI-driven run workflow](/terraform/cloud-docs/run/cli). When you use the CLI workflow, operations like `terraform plan` or `terraform apply` are remotely executed in HCP Terraform's run environment by default, with log output streaming to the local terminal. This lets you use HCP Terraform features within the familiar Terraform CLI workflow, including variables encrypted at rest in an HCP Terraform workspace, cost estimates, and policy checking. -> **Hands On:** Try the [Migrate State to HCP Terraform](/terraform/tutorials/cloud/cloud-migrate) tutorial. +> **Hands On:** Try the [Migrate State to HCP Terraform](/terraform/tutorials/cloud/cloud-migrate) tutorial. To learn how to migrate multiple state files to HCP Terraform at once, try the [Migrate to HCP Terraform in bulk](/terraform/tutorials/cloud/bulk-migrate-hcp) tutorial and refer to the [Terraform migrate documentation](/terraform/cloud-docs/migrate/tf-migrate). Workspaces can also be configured for local execution, in which case HCP Terraform only stores state. In this mode, HCP Terraform behaves just like a standard state backend. diff --git a/website/docs/cli/cloud/settings.mdx b/website/docs/cli/cloud/settings.mdx index 24f32293336e..c67fd358ca46 100644 --- a/website/docs/cli/cloud/settings.mdx +++ b/website/docs/cli/cloud/settings.mdx @@ -8,7 +8,7 @@ description: >- This topic describes how to connect the Terraform CLI to HCP Terraform. Integrating the CLI with HCP Terraform enables the CLI to act as a client for CLI-drive workflows. Refer to [CLI-driven Run Workflow](/terraform/cloud-docs/run/cli) for additional information. -> **Hands On:** Complete the [Migrate State to HCP Terraform](/terraform/tutorials/cloud/cloud-migrate) tutorial to learn more about integrating the CLI with HCP Terraform. +> **Hands On:** Complete the [Migrate State to HCP Terraform](/terraform/tutorials/cloud/cloud-migrate) tutorial to learn more about integrating the CLI with HCP Terraform. To learn how to migrate multiple state files to HCP Terraform at once, try the [Migrate to HCP Terraform in bulk](/terraform/tutorials/cloud/bulk-migrate-hcp) tutorial and refer to the [Terraform migrate documentation](/terraform/cloud-docs/migrate/tf-migrate). ## Overview diff --git a/website/docs/intro/phases/collaborate.mdx b/website/docs/intro/phases/collaborate.mdx index 4b391105097d..aaed13e48806 100644 --- a/website/docs/intro/phases/collaborate.mdx +++ b/website/docs/intro/phases/collaborate.mdx @@ -28,6 +28,12 @@ As your team grows, you may run into the risk of concurrent operations on state [Get started with HCP Terraform](/terraform/tutorials/cloud-get-started) and learn how to [securely store your Terraform state](/well-architected-framework/security/security-sensitive-data#storing-terraform-state). +Refer to the following resources to learn how to migrate to HCP Terraform: + +- [Migrate Terraform state to HCP Terraform](/terraform/cloud-docs/migrate) documentation. +- [Migrate to HCP Terraform in bulk](/terraform/tutorials/cloud/bulk-migrate-hcp) tutorial. +- [Terraform migrate](/terraform/cloud-docs/migrate/tf-migrate) documentation. + ## Implement code reviews Implement good code practices for your Terraform configuration, including using pull requests for code changes and performing proper code reviews. diff --git a/website/docs/language/backend/index.mdx b/website/docs/language/backend/index.mdx index b77d67067471..2d8c8d52f08f 100644 --- a/website/docs/language/backend/index.mdx +++ b/website/docs/language/backend/index.mdx @@ -214,11 +214,19 @@ the reinitialization process, Terraform will ask if you'd like to migrate your existing state to the new configuration. This allows you to easily switch from one backend to another. -If you're using multiple [workspaces](/terraform/language/state/workspaces), +If you are using multiple [workspaces](/terraform/language/state/workspaces), Terraform can copy all workspaces to the destination. If Terraform detects you have multiple workspaces, it will ask if this is what you want to do. -If you're just reconfiguring the same backend, Terraform will still ask if you +If you are migrating multiple root Terraform configurations to HCP Terraform, +you can use the [Terraform migrate](/terraform/cloud-docs/migrate/tf-migrate) +tool to migrate all of your configurations and workspaces in bulk. + +> **Hands On:** Complete the [Migrate to HCP Terraform in +bulk](/terraform/tutorials/cloud/bulk-migrate-hcp) tutorial to learn more +about migrating multiple Terraform configuration to HCP Terraform. + +If you are reconfiguring the same backend, Terraform will still ask if you want to migrate your state. You can respond "no" in this scenario. ## Remove a backend configuration diff --git a/website/docs/language/state/remote.mdx b/website/docs/language/state/remote.mdx index 73875a2c17bc..fff3e246a100 100644 --- a/website/docs/language/state/remote.mdx +++ b/website/docs/language/state/remote.mdx @@ -18,6 +18,11 @@ which can then be shared between all members of a team. Terraform supports storing state in [HCP Terraform](https://www.hashicorp.com/products/terraform/), [HashiCorp Consul](https://www.consul.io/), Amazon S3, Azure Blob Storage, Google Cloud Storage, Alibaba Cloud OSS, and more. +> **Hands On:** Try the [Migrate State to HCP Terraform](/terraform/tutorials/cloud/cloud-migrate) +tutorial. To learn how to migrate multiple state files to HCP Terraform at once, try the +[Migrate to HCP Terraform in bulk](/terraform/tutorials/cloud/bulk-migrate-hcp) tutorial and refer +to the [Terraform migrate documentation](/terraform/cloud-docs/migrate/tf-migrate). + Remote state is implemented by a [backend](/terraform/language/backend) or by HCP Terraform, both of which you can configure in your configuration's root module.