github.com/loicalbertin/terraform@v0.6.15-0.20170626182346-8e2583055467/website/docs/configuration/terraform-enterprise.html.md (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Configuring Terraform Enterprise"
     4  sidebar_current: "docs-config-terraform-enterprise"
     5  description: |-
     6    Terraform Enterprise is the ideal way to use Terraform in a team environment. Terraform Enterprise will run Terraform for you, safely handle parallelization across different team members, save run history along with plans, and more.
     7  ---
     8  
     9  # Terraform Enterprise Configuration
    10  
    11  Terraform can be configured to be able to upload to HashiCorp's
    12  [Terraform Enterprise](https://www.hashicorp.com/products/terraform/). This configuration doesn't change
    13  the behavior of Terraform itself, it only configures your Terraform
    14  configuration to support being uploaded to Terraform Enterprise via the
    15  [push command](/docs/commands/push.html).
    16  
    17  For more information on the benefits of uploading your Terraform
    18  configuration to Terraform Enterprise, please see the
    19  [push command documentation](/docs/commands/push.html).
    20  
    21  This page assumes you're familiar with the
    22  [configuration syntax](/docs/configuration/syntax.html)
    23  already.
    24  
    25  ~> **Why is this called "atlas"?** Atlas was previously a commercial offering
    26  from HashiCorp that included a full suite of enterprise products. The products
    27  have since been broken apart into their individual products, like **Terraform
    28  Enterprise**. While this transition is in progress, you may see references to
    29  "atlas" in the documentation. We apologize for the inconvenience.
    30  
    31  ## Example
    32  
    33  Terraform Enterprise configuration looks like the following:
    34  
    35  ```hcl
    36  atlas {
    37    name = "mitchellh/production-example"
    38  }
    39  ```
    40  
    41  ## Description
    42  
    43  The `atlas` block configures the settings when Terraform is
    44  [pushed](/docs/commands/push.html) to Terraform Enterprise. Only one `atlas` block
    45  is allowed.
    46  
    47  Within the block (the `{ }`) is configuration for Atlas uploading.
    48  No keys are required, but the key typically set is `name`.
    49  
    50  **No value within the `atlas` block can use interpolations.** Due
    51  to the nature of this configuration, interpolations are not possible.
    52  If you want to parameterize these settings, use the Atlas block to
    53  set defaults, then use the command-line flags of the
    54  [push command](/docs/commands/push.html) to override.
    55  
    56  ## Syntax
    57  
    58  The full syntax is:
    59  
    60  ```text
    61  atlas {
    62    name = VALUE
    63  }
    64  ```