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

     1  ---
     2  layout: "backend-types"
     3  page_title: "Backend Type: terraform enterprise"
     4  sidebar_current: "docs-backends-types-standard-terraform-enterprise"
     5  description: |-
     6    Terraform can store the state in Terraform Enterprise
     7  ---
     8  
     9  # terraform enterprise
    10  
    11  **Kind: Standard (with no locking)**
    12  
    13  Stores the state in [Terraform Enterprise](https://www.terraform.io/docs/providers/index.html).
    14  
    15  You can create a new environment in the
    16  Environments section and generate new token in the Tokens page under Settings.
    17  
    18  ~> **Why is this called "atlas"?** Atlas was previously a commercial offering
    19  from HashiCorp that included a full suite of enterprise products. The products
    20  have since been broken apart into their individual products, like **Terraform
    21  Enterprise**. While this transition is in progress, you may see references to
    22  "atlas" in the documentation. We apologize for the inconvenience.
    23  
    24  ## Example Configuration
    25  
    26  ```hcl
    27  terraform {
    28    backend "atlas" {
    29      name         = "bigbang/example"
    30      access_token = "foo"
    31    }
    32  }
    33  ```
    34  
    35  Note that for the access token we recommend using a
    36  [partial configuration](/docs/backends/config.html).
    37  
    38  ## Example Referencing
    39  
    40  ```hcl
    41  data "terraform_remote_state" "foo" {
    42    backend = "atlas"
    43    config {
    44      name         = "bigbang/example"
    45      access_token = "X2iTFefU5aWOjg.atlasv1.YaDa"
    46    }
    47  }
    48  ```
    49  
    50  ## Configuration variables
    51  
    52  The following configuration options / environment variables are supported:
    53  
    54   * `name` - (Required) Full name of the environment (`<username>/<name>`)
    55   * `access_token` / `ATLAS_TOKEN` - (Required) Terraform Enterprise API token
    56   * `address` - (Optional) Address to alternative Terraform Enterprise location (Terraform Enterprise endpoint)