consul_kv – Выборка метаданных из хранилища значений ключей Consul
Обзор
- Поиск метаданных для плана выполнения из хранилища значений ключей в кластере Consul. Значения можно легко установить в хранилище kv с помощью простых команд rest
curl -X PUT -d 'some-value' http://localhost:8500/v1/kv/ansible/somedata
Требования
Ниже перечислены требования к локальному узлу-мастеру, на котором выполняется этот поиск.
- python-consul python библиотека https://python-consul.readthedocs.io/en/latest/#installation
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| _raw список / обязательно | Список ключей для извлечения. | ||
| client_cert - добавлен в 2.8 | записи ini: [lookup_consul] переменная окружения:ANSIBLE_CONSUL_CLIENT_CERT | Сертификат клиента для проверки ssl-соединения. | |
| datacenter - добавлен в 2.9 | Извлечь ключ из центра данных consul, отличного от стандартного для узла consul. | ||
| host - добавлен в 2.8 | По умолчанию: "localhost" | записи ini: [lookup_consul] переменная окружения:ANSIBLE_CONSUL_URL | Целевой узел для подключения, должен быть разрешимым адресом. Будет определён из ANSIBLE_CONSUL_URL если он установлен.ANSIBLE_CONSUL_URL должен выглядеть так: https://my.consul.server:8500
|
| index - | Если ключ имеет значение с указанным индексом, то это значение возвращается, позволяя получить доступ к историческим значениям. | ||
| port - | По умолчанию: 8500 | Порт целевого узла для подключения. Если вы используете ANSIBLE_CONSUL_URL, это значение будет взято оттуда. | |
| recurse булево | По умолчанию: "нет" | Если true, будут извлечены все значения, имеющие заданный ключ в качестве префикса. | |
| scheme - добавлен в 2.8 | По умолчанию: "http" | Использование http или https. Если вы используете ANSIBLE_CONSUL_URL, это значение будет взято оттуда. | |
| token - | Токен acl для доступа к ограниченным значениям. | ||
| validate_certs - добавлен в 2.8 | По умолчанию: "да" | записи ini: [lookup_consul] переменная окружения:ANSIBLE_CONSUL_VALIDATE_CERTS | Проверка ssl-соединения или нет. |
Примеры
- 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}}'
with_consul_kv:
- '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') }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _raw - | Сохранённое(ые) значение(я) в consul. |
Статус
- Данный поиск не гарантирует обратной совместимости интерфейса. [предварительная версия]
- Этот поиск поддерживается сообществом Ansible. [сообщество]
Авторы
- НЕИЗВЕСТНО
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете изменить этот документ для его улучшения.
Подсказка
Записи конфигурации для каждого типа имеют порядок приоритета от низкого к высокому. Например, переменная, которая находится ниже в списке, переопределит переменную, расположенную выше.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/plugins/lookup/consul_kv.html
