github.com/pdecat/terraform@v0.11.9-beta1/website/docs/configuration/terraform-enterprise.html.md (about)

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