Using Terraform Cloud with Terraform CLI
The Terraform CLI integration with Terraform Cloud lets you use Terraform Cloud and Terraform Enterprise on the command line. In the documentation Terraform Cloud instructions also apply to Terraform Enterprise, except where explicitly stated.
Using Terraform Cloud through the command line is called the CLI-driven run workflow. When you use the CLI workflow, operations like
terraform plan or
terraform apply are remotely executed in Terraform Cloud's run environment by default, with log output streaming to the local terminal. This lets you use Terraform Cloud features within the familiar Terraform CLI workflow, including variables encrypted at rest in a Terraform Cloud workspace, cost estimates, and policy checking.
Hands On: Try the Migrate State to Terraform Cloud tutorial.
Workspaces can also be configured for local execution, in which case Terraform Cloud only stores state. In this mode, Terraform Cloud behaves just like a standard state backend.
Note: The CLI integration is available in Terraform 1.1.0 and later, and Terraform Enterprise 202201-1 and later. Previous versions can use the
remote backend. Refer to Migrating from the remote
backend for details about switching to the CLI integration.
- Terraform Cloud Settings documents the
cloudblock that you must add to your configuration to enable Terraform Cloud support.
- Initializing and Migrating describes how to start using Terraform Cloud with a working directory that already has state data.
- Command Line Arguments lists the Terraform command flags that are specific to using Terraform with Terraform Cloud.
Refer to the CLI-driven Run Workflow for more details about how to use Terraform Cloud from the command line.