github.com/jmbataller/terraform@v0.6.8-0.20151125192640-b7a12e3a580c/website/source/docs/configuration/atlas.html.md (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Configuring Atlas"
     4  sidebar_current: "docs-config-atlas"
     5  description: |-
     6    Atlas is the ideal way to use Terraform in a team environment. Atlas will run Terraform for you, safely handle parallelization across different team members, save run history along with plans, and more.
     7  ---
     8  
     9  # Atlas Configuration
    10  
    11  Terraform can be configured to be able to upload to HashiCorp's
    12  [Atlas](https://atlas.hashicorp.com). This configuration doesn't change
    13  the behavior of Terraform itself, it only configures your Terraform
    14  configuration to support being uploaded to Atlas via the
    15  [push command](/docs/commands/push.html).
    16  
    17  For more information on the benefits of uploading your Terraform
    18  configuration to Atlas, 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  ## Example
    26  
    27  Atlas configuration looks like the following:
    28  
    29  ```
    30  atlas {
    31  	name = "mitchellh/production-example"
    32  }
    33  ```
    34  
    35  ## Description
    36  
    37  The `atlas` block configures the settings when Terraform is
    38  [pushed](/docs/commands/push.html) to Atlas. Only one `atlas` block
    39  is allowed.
    40  
    41  Within the block (the `{ }`) is configuration for Atlas uploading.
    42  No keys are required, but the key typically set is `name`.
    43  
    44  **No value within the `atlas` block can use interpolations.** Due
    45  to the nature of this configuration, interpolations are not possible.
    46  If you want to parameterize these settings, use the Atlas block to
    47  set defaults, then use the command-line flags of the
    48  [push command](/docs/commands/push.html) to override.
    49  
    50  ## Syntax
    51  
    52  The full syntax is:
    53  
    54  ```
    55  atlas {
    56  	name = VALUE
    57  }
    58  ```