consul_kv – Управление записями в хранилище ключ/значение кластера consul

• Обзор
• Требования
• Параметры
• Примеры
• Статус

Обзор

• Позволяет извлекать, добавлять, изменять и удалять записи ключ/значение в кластере consul через агент. Весь контент записи, включая индексы, флаги и сессию, возвращается как «значение».
• Если ключ представляет собой префикс, обратите внимание, что при удалении значения, любое существующее значение возвращается как часть результатов.
• Для получения более подробной информации см. http://www.consul.io/docs/agent/http.html#kv.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

• python >= 2.6
• python-consul
• requests

Параметры

Примеры

# If the key does not exist, the value associated to the "data" property in `retrieved_key` will be `None`
# If the key value is empty string, `retrieved_key["data"]["Value"]` will be `None`
- name: retrieve a value from the key/value store
  consul_kv:
    key: somekey
  register: retrieved_key

- name: Add or update the value associated with a key in the key/value store
  consul_kv:
    key: somekey
    value: somevalue

- name: Remove a key from the store
  consul_kv:
    key: somekey
    state: absent

- name: Add a node to an arbitrary group via consul inventory (see consul.ini)
  consul_kv:
    key: ansible/groups/dc1/somenode
    value: top_secret

- name: Register a key/value pair with an associated session
  consul_kv:
    key: stg/node/server_birthday
    value: 20160509
    session: "{{ sessionid }}"
    state: acquire

Статус

• Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
• Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

• Steve Gargan (@sgargan)
• Colin Nolan (@colin-nolan)