mirror of
https://github.com/opentffoundation/opentf.git
synced 2025-12-25 01:00:16 -05:00
4c0bda5386
Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
29 lines
1.0 KiB
Plaintext
29 lines
1.0 KiB
Plaintext
---
|
|
description: >-
|
|
The nested `cloud` block configures OpenTofu's integration with a cloud backend.
|
|
---
|
|
|
|
# Cloud Configuration
|
|
|
|
The main module of an OpenTofu configuration can integrate with a cloud backend to enable its [CLI-driven run workflow](/docs/cloud-docs/run/cli). You only need to configure these settings when you want to use OpenTofu CLI to interact with a cloud backend.
|
|
A cloud backend ignores them when interacting with OpenTofu through version control or the API.
|
|
|
|
## Usage Example
|
|
|
|
To configure the cloud CLI integration, add a nested `cloud` block within the `terraform` block. You cannot use the CLI integration and a [state backend](/docs/language/settings/backends/configuration) in the same configuration.
|
|
|
|
Refer to [Using the Cloud Backend](/docs/cli/cloud) in the OpenTofu CLI documentation for full configuration details, migration instructions, and command line arguments.
|
|
|
|
```hcl
|
|
terraform {
|
|
cloud {
|
|
organization = "example_corp"
|
|
hostname = "app.example.io"
|
|
|
|
workspaces {
|
|
tags = ["app"]
|
|
}
|
|
}
|
|
}
|
|
```
|