cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

consul_kv: Fix name & formatting (#32132)

Browse source 
* Fix name & formatting
* Fix examples
This commit is contained in:
John R Barker 2017-10-25 14:39:49 +01:00 committed by René Moser
parent ca115b0a8e
commit 0e36854213
1 changed files with 18 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

34
lib/ansible/plugins/lookup/consul_kv.py
View file

@ -5,58 +5,60 @@ from __future__ import (absolute_import, division, print_function)
__metaclass__ = type
DOCUMENTATION = """
lookup: cartesian
lookup: consul_kv
version_added: "1.9"
short_description: grab metadata from a consul key value store.
short_description: Fetch metadata from a Consul key value store.
description:
- lookup metadata for a playbook from the key value store in a consul cluster.
- Lookup metadata for a playbook from the key value store in a Consul cluster.
Values can be easily set in the kv store with simple rest commands
- "curl -X PUT -d 'some-value' http://localhost:8500/v1/kv/ansible/somedata"
- C(curl -X PUT -d 'some-value' http://localhost:8500/v1/kv/ansible/somedata)
requirements:
- 'python-consul (python library http://python-consul.readthedocs.org/en/latest/#installation)'
- 'python-consul python library U(http://python-consul.readthedocs.org/en/latest/#installation)'
options:
_raw:
description: key(s) to retrieve
description: List of key(s) to retrieve.
type: list
required: True
recurse:
type: boolean
description: if true, will retrieve all the values that have the given key as prefix
description: If true, will retrieve all the values that have the given key as prefix.
default: False
index:
description: if the key has a value with the specified index then this is returned allowing access to historical values.
description: If the key has a value with the specified index then this is returned allowing access to historical values.
token:
description: acl token to allow access to restricted values.
description: The acl token to allow access to restricted values.
host:
default: localhost
description:
- the target to connect to, must be a resolvable address.
- The target to connect to, must be a resolvable address.
env:
- name: ANSIBLE_CONSUL_URL
port:
description: the port of the target host to connect to.
description: The port of the target host to connect to.
default: 8500
"""
EXAMPLES = """
- debug: msg='key contains {{item}}'
- debug:
msg: 'key contains {{item}}'
with_consul_kv:
- 'key/to/retrieve'
- name: Parameters can be provided after the key be more specific about what to retrieve
debug: msg='key contains {{item}}'
debug:
msg: 'key contains {{item}}'
with_consul_kv:
- 'key/to recurse=true token=E6C060A9-26FB-407A-B83E-12DDAFCB4D98')}}'
- 'key/to recurse=true token=E6C060A9-26FB-407A-B83E-12DDAFCB4D98'
- name: retrieving a KV from a remote cluster on non default port
debug:
msg: "{{ lookup('consul_kv', 'my/key', host='10.10.10.10', port='2000')
msg: "{{ lookup('consul_kv', 'my/key', host='10.10.10.10', port='2000') }}"
"""
RETURN = """
_raw:
description:
- value(s) stored in consul
- Value(s) stored in consul.
"""
import os