github.com/rstandt/terraform@v0.12.32-0.20230710220336-b1063613405c/website/docs/configuration-0-11/terraform-enterprise.html.md (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Terraform Push - 0.11 Configuration Language"
     4  sidebar_current: "docs-conf-old-push"
     5  description: |-
     6    Terraform's push command was a way to interact with the legacy version of Terraform Enterprise. It is not supported in the current version of Terraform Enterprise.
     7  ---
     8  
     9  # Terraform Push Configuration
    10  
    11  -> **Note:** This page is about Terraform 0.11 and earlier, and documents a
    12  feature that was removed in Terraform 0.12.
    13  
    14  ~> **Important:** The `terraform push` command is deprecated, and only works with the legacy version of Terraform Enterprise. In the current version of Terraform Cloud, you can upload configurations using the API. See [the docs about API-driven runs](/docs/cloud/run/api.html) for more details.
    15  
    16  The [`terraform push` command](/docs/commands/push.html) uploads a configuration to a Terraform Enterprise (legacy) environment. The name of the environment (and the organization it's in) can be specified on the command line, or as part of the Terraform configuration in an `atlas` block.
    17  
    18  The `atlas` block does not configure remote state; it only configures the push command. For remote state, [use a `terraform { backend "<NAME>" {...} }` block](/docs/backends/config.html).
    19  
    20  This page assumes you're familiar with the
    21  [configuration syntax](./syntax.html)
    22  already.
    23  
    24  ## Example
    25  
    26  Terraform push configuration looks like the following:
    27  
    28  ```hcl
    29  atlas {
    30    name = "mitchellh/production-example"
    31  }
    32  ```
    33  
    34  ~> **Why is this called "atlas"?** Atlas was previously a commercial offering
    35  from HashiCorp that included a full suite of enterprise products. The products
    36  have since been broken apart into their individual products, like **Terraform
    37  Enterprise**. While this transition is in progress, you may see references to
    38  "atlas" in the documentation. We apologize for the inconvenience.
    39  
    40  ## Description
    41  
    42  The `atlas` block configures the settings when Terraform is
    43  [pushed](/docs/commands/push.html) to Terraform Enterprise. Only one `atlas` block
    44  is allowed.
    45  
    46  Within the block (the `{ }`) is configuration for Atlas uploading.
    47  No keys are required, but the key typically set is `name`.
    48  
    49  **No value within the `atlas` block can use interpolations.** Due
    50  to the nature of this configuration, interpolations are not possible.
    51  If you want to parameterize these settings, use the Atlas block to
    52  set defaults, then use the command-line flags of the
    53  [push command](/docs/commands/push.html) to override.
    54  
    55  ## Syntax
    56  
    57  The full syntax is:
    58  
    59  ```text
    60  atlas {
    61    name = VALUE
    62  }
    63  ```