2017-02-15 19:47:30 +01:00
|
|
|
---
|
2017-02-15 21:19:38 +01:00
|
|
|
layout: "backend-types"
|
2017-03-23 20:28:10 +01:00
|
|
|
page_title: "Backend Type: terraform enterprise"
|
2017-04-07 06:14:57 +02:00
|
|
|
sidebar_current: "docs-backends-types-standard-terraform-enterprise"
|
2017-02-15 19:47:30 +01:00
|
|
|
description: |-
|
2017-03-23 20:28:10 +01:00
|
|
|
Terraform can store the state in Terraform Enterprise
|
2017-02-15 19:47:30 +01:00
|
|
|
---
|
|
|
|
|
2017-03-23 20:28:10 +01:00
|
|
|
# terraform enterprise
|
2017-02-15 19:47:30 +01:00
|
|
|
|
2017-02-15 21:19:38 +01:00
|
|
|
**Kind: Standard (with no locking)**
|
|
|
|
|
2017-03-23 20:28:10 +01:00
|
|
|
Stores the state in [Terraform Enterprise](https://www.terraform.io/docs/providers/index.html).
|
2017-02-15 19:47:30 +01:00
|
|
|
|
2017-02-15 21:19:38 +01:00
|
|
|
You can create a new environment in the
|
2017-03-23 20:28:10 +01:00
|
|
|
Environments section and generate new token in the Tokens page under Settings.
|
2017-02-15 19:47:30 +01:00
|
|
|
|
2017-02-15 21:19:38 +01:00
|
|
|
## Example Configuration
|
2017-02-15 19:47:30 +01:00
|
|
|
|
2017-04-05 17:29:27 +02:00
|
|
|
```hcl
|
2017-02-15 21:19:38 +01:00
|
|
|
terraform {
|
|
|
|
backend "atlas" {
|
|
|
|
name = "bigbang/example"
|
|
|
|
access_token = "foo"
|
|
|
|
}
|
|
|
|
}
|
2017-02-15 19:47:30 +01:00
|
|
|
```
|
|
|
|
|
2017-02-15 21:19:38 +01:00
|
|
|
Note that for the access token we recommend using a
|
|
|
|
[partial configuration](/docs/backends/config.html).
|
|
|
|
|
2017-02-15 19:47:30 +01:00
|
|
|
## Example Referencing
|
|
|
|
|
2017-04-05 17:29:27 +02:00
|
|
|
```hcl
|
2017-02-15 19:47:30 +01:00
|
|
|
data "terraform_remote_state" "foo" {
|
2017-04-05 17:29:27 +02:00
|
|
|
backend = "atlas"
|
|
|
|
config {
|
|
|
|
name = "bigbang/example"
|
|
|
|
access_token = "X2iTFefU5aWOjg.atlasv1.YaDa"
|
|
|
|
}
|
2017-02-15 19:47:30 +01:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
## Configuration variables
|
|
|
|
|
|
|
|
The following configuration options / environment variables are supported:
|
|
|
|
|
|
|
|
* `name` - (Required) Full name of the environment (`<username>/<name>`)
|
2017-03-23 20:28:10 +01:00
|
|
|
* `access_token` / `ATLAS_TOKEN` - (Required) Terraform Enterprise API token
|
|
|
|
* `address` - (Optional) Address to alternative Terraform Enterprise location (Terraform Enterprise endpoint)
|