community.general/contrib/inventory/consul.ini

# Ansible Consul external inventory script settings.

[consul]

# restrict included nodes to those from this datacenter
#datacenter = nyc1

# url of the the consul cluster to query
#url = http://demo.consul.io
url = http://localhost:8500

# suffix added to each service to create a group name e.g Service of 'redis' and
# a suffix of '_servers' will add each address to the group name 'redis_servers'
servers_suffix = _servers

# if specified then the inventory will generate domain names that will resolve
# via Consul's inbuilt DNS. 
#domain=consul

# make groups from service tags. the name of the group is derived from the
# service name and the tag name e.g. a service named nginx with tags ['master', 'v1']
# will create groups nginx_master and nginx_v1
tags = true

# looks up the node name at the given path for a list of groups to which the
# node should be added.
kv_groups=ansible/groups

# looks up the node name at the given path for a json dictionary of metadata that
# should be attached as metadata for the node
kv_metadata=ansible/metadata

# looks up the health of each service and adds the node to 'up' and 'down' groups
# based on the service availibility
availability = true
available_suffix = _up
unavailable_suffix = _down
Initial commit of Ansible support for the Consul clustering framework (http://consul.io). Submission includes support for - creating and registering services and checks - reading, writing and lookup for values in consul's kv store - creating and manipulating sessions for distributed locking on values in the kv - creating and manipulating ACLs for restricting access to the kv store - inventory support that reads the Consul catalog and group nodes according to - datacenters - exposed services - service availability - arbitrary groupings from the kv store This submission makes extensive use of the python-consul library and this is required as a dependency and can be installed from pip. The tests were written to target a vagrant cluster which can be setup by following the instructions here http://github.com/sgargan/consul-vagrant 2015-01-24 02:09:03 +01:00			`# Ansible Consul external inventory script settings.`

			`[consul]`

			`# restrict included nodes to those from this datacenter`
			`#datacenter = nyc1`

			`# url of the the consul cluster to query`
			`#url = http://demo.consul.io`
			`url = http://localhost:8500`

			`# suffix added to each service to create a group name e.g Service of 'redis' and`
			`# a suffix of '_servers' will add each address to the group name 'redis_servers'`
			`servers_suffix = _servers`

			`# if specified then the inventory will generate domain names that will resolve`
			`# via Consul's inbuilt DNS.`
			`#domain=consul`

			`# make groups from service tags. the name of the group is derived from the`
			`# service name and the tag name e.g. a service named nginx with tags ['master', 'v1']`
			`# will create groups nginx_master and nginx_v1`
			`tags = true`

			`# looks up the node name at the given path for a list of groups to which the`
			`# node should be added.`
			`kv_groups=ansible/groups`

			`# looks up the node name at the given path for a json dictionary of metadata that`
			`# should be attached as metadata for the node`
			`kv_metadata=ansible/metadata`

			`# looks up the health of each service and adds the node to 'up' and 'down' groups`
			`# based on the service availibility`
			`availability = true`
			`available_suffix = _up`
			`unavailable_suffix = _down`