github.com/xsb/terraform@v0.6.13-0.20160314145438-fe415c2f09d7/website/source/docs/state/remote/atlas.html.md (about)

     1  ---
     2  layout: "remotestate"
     3  page_title: "Remote State Backend: atlas"
     4  sidebar_current: "docs-state-remote-atlas"
     5  description: |-
     6    Terraform can store the state remotely, making it easier to version and work with in a team.
     7  ---
     8  
     9  # atlas
    10  
    11  Stores the state in [Atlas](https://atlas.hashicorp.com/).
    12  
    13  You can create a new environment in the [Environments section](https://atlas.hashicorp.com/environments)
    14  and generate new token in the [Tokens page](https://atlas.hashicorp.com/settings/tokens) under Settings.
    15  
    16  ## Example Usage
    17  
    18  ```
    19  terraform remote config \
    20  	-backend=atlas \
    21  	-backend-config="name=bigbang/example" \
    22  	-backend-config="access_token=X2iTFefU5aWOjg.atlasv1.YaDa" \
    23  ```
    24  
    25  ## Example Referencing
    26  
    27  ```
    28  resource "terraform_remote_state" "foo" {
    29  	backend = "atlas"
    30  	config {
    31  		name = "bigbang/example"
    32  		access_token = "X2iTFefU5aWOjg.atlasv1.YaDa"
    33  	}
    34  }
    35  ```
    36  
    37  ## Configuration variables
    38  
    39  The following configuration options / environment variables are supported:
    40  
    41   * `name` - (Required) Full name of the environment (`<username>/<name>`)
    42   * `access_token` / `ATLAS_TOKEN` - (Required) Atlas API token
    43   * `address` - (Optional) Address to alternative Atlas location (Atlas Enterprise endpoint)