terraform/website/source/docs/providers/consul/index.html.markdown

47 lines
1.1 KiB
Markdown
Raw Normal View History

2014-07-27 02:42:25 +02:00
---
layout: "consul"
page_title: "Provider: Consul"
sidebar_current: "docs-consul-index"
---
# Consul Provider
2014-07-28 16:49:51 +02:00
[Consul](http://www.consul.io) is a tool for service discovery, configuration
and orchestration. The Consul provider exposes resources used to interact with a
Consul cluster. Configuration of the provider is optional, as it provides
defaults for all arguments.
2014-07-27 02:42:25 +02:00
Use the navigation to the left to read about the available resources.
## Example Usage
```
# Configure the Consul provider
provider "consul" {
address = "demo.consul.io:80"
datacenter = "nyc1"
}
# Access a key in Consul
resource "consul_keys" "app" {
key {
name = "ami"
path = "service/app/launch_ami"
default = "ami-1234"
}
}
# Use our variable from Consul
resource "aws_instance" "app" {
ami = "${consul_keys.app.var.ami}"
}
```
## Argument Reference
The following arguments are supported:
2014-07-29 02:21:18 +02:00
* `address` - (Optional) The HTTP API address of the agent to use. Defaults to "127.0.0.1:8500".
2014-07-27 02:42:25 +02:00
* `datacenter` - (Optional) The datacenter to use. Defaults to that of the agent.