42 lines
970 B
Markdown
42 lines
970 B
Markdown
|
---
|
||
|
|
layout: "remotestate"
|
||
|
|
page_title: "Remote State Backend: etcd"
|
||
|
|
sidebar_current: "docs-state-remote-etcd"
|
||
|
|
description: |-
|
||
|
|
Terraform can store the state remotely, making it easier to version and work with in a team.
|
||
|
|
---
|
||
|
|
|
||
|
|
# etcd
|
||
|
|
|
||
|
|
Stores the state in [etcd](https://coreos.com/etcd/) at a given path.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```
|
||
|
|
terraform remote config \
|
||
|
|
-backend=etcd \
|
||
|
|
-backend-config="path=path/to/terraform.tfstate" \
|
||
|
|
-backend-config="endpoints=http://one:4001 http://two:4001"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example Referencing
|
||
|
|
|
||
|
|
```
|
||
|
|
resource "terraform_remote_state" "foo" {
|
||
|
|
backend = "etcd"
|
||
|
|
config {
|
||
|
|
path = "path/to/terraform.tfstate"
|
||
|
|
endpoints = "http://one:4001 http://two:4001"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Configuration variables
|
||
|
|
|
||
|
|
The following configuration options are supported:
|
||
|
|
|
||
|
|
* `path` - (Required) The path where to store the state
|
||
|
|
* `endpoints` - (Required) A space-separated list of the etcd endpoints
|
||
|
|
* `username` - (Optional) The username
|
||
|
|
* `password` - (Optional) The password
|