36 lines
1.5 KiB
Plaintext
36 lines
1.5 KiB
Plaintext
---
|
|
page_title: Terraform Cloud Configuration - Terraform Settings - Configuration Language
|
|
description: >-
|
|
The nested `cloud` block configures Terraform's integration with Terraform
|
|
Cloud.
|
|
---
|
|
|
|
# Terraform Cloud Configuration
|
|
|
|
The main module of a Terraform configuration can integrate with Terraform Cloud to enable its
|
|
[CLI-driven run workflow](/cloud-docs/run/cli). You only need to configure these settings when you want to use Terraform CLI to interact with Terraform Cloud. Terraform Cloud ignores them when interacting with
|
|
Terraform through version control or the API.
|
|
|
|
> **Hands On:** Try the [Migrate State to Terraform Cloud](https://learn.hashicorp.com/tutorials/terraform/cloud-migrate) tutorial on HashiCorp Learn.
|
|
|
|
You can configure the Terraform Cloud CLI integration by adding a nested `cloud` block within the top-level
|
|
`terraform` block:
|
|
|
|
```hcl
|
|
terraform {
|
|
cloud {
|
|
organization = "example_corp"
|
|
|
|
workspaces {
|
|
tags = ["app"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
You cannot use the CLI integration and a [state backend](/language/settings/backends) in the same configuration; they are mutually exclusive.
|
|
A configuration can only provide one `cloud` block and the `cloud` block cannot refer to named values like input variables, locals, or data source attributes.
|
|
Note that a `cloud` block can be overridden by a state backend in an [override file](/language/files/override#merging-terraform-blocks).
|
|
|
|
Refer to [Using Terraform Cloud](/cli/cloud) in the Terraform CLI docs for more information.
|