community.general.etcd3 – Получение значений ключей из сервера etcd3

Примечание

Этот плагин входит в сборку community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.etcd3.

Новое в версии 0.2.0: сборки community.general

Обзор
Требования
Параметры
Примечания
См. также
Примеры
Возвращаемые значения

Обзор

Извлекает значения ключей и/или префиксы ключей с сервера etcd3, используя его собственный API gRPC.
Попытайтесь повторно использовать параметры подключения community.general.etcd3, но добавьте поддержку некоторых ETCDCTL_* переменных окружения.
См. https://github.com/etcd-io/etcd/tree/master/Documentation/op-guide для общего обзора etcd.

Требования

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

etcd3 >= 0.10

Параметры

Параметр	Варианты/Значения по умолчанию	Конфигурация	Комментарии
_terms список / элементы=строка / обязательный			Список ключей (или префиксов ключей) для поиска на сервере etcd3.
ca_cert строка		env:ETCDCTL_CACERT	Удостоверение CA сервера etcd3.
cert_cert строка		env:ETCDCTL_CERT	Клиентский сертификат сервера etcd3.
cert_key строка		env:ETCDCTL_KEY	Приватный ключ клиента сервера etcd3.
endpoints строка	По умолчанию: "127.0.0.1:2379"	env:ETCDCTL_ENDPOINTS	Аналог переменной окружения `ETCDCTL_ENDPOINTS`. Укажите соединение с etcd3 в формате URL, например, `https://hostname:2379` или `<host>:<port>`. Часть `host` перезаписывается параметром host, если он определен. Часть `port` перезаписывается параметром port, если он определен.
host строка			Хост, на котором прослушивает клиент etcd3. Имеет приоритет над параметром endpoints.
password строка		env:ETCDCTL_PASSWORD	Пароль аутентифицированного пользователя.
port целое число			Порт, на котором прослушивает клиент etcd3. Имеет приоритет над параметром endpoints.
prefix логическое значение	Варианты: нет ← да		Искать ключ или префикс ключа.
timeout целое число	По умолчанию: 60	env:ETCDCTL_DIAL_TIMEOUT	Таймаут клиента.
user строка		env:ETCDCTL_USER	Имя аутентифицированного пользователя.

Примечания

Примечание

Параметры host и port имеют приоритет над параметром endpoints.
Рекомендуемый способ подключения к серверу etcd3 — использование ETCDCTL_ENDPOINT переменной окружения и оставление параметров endpoints, host и port без использования.

См. также

community.general.etcd3: Официальная документация модуля community.general.etcd3.
etcd – получение информации с сервера etcd: Поиск etcd v2.

Примеры

- name: "a value from a locally running etcd"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd3', 'foo/bar') }}"

- name: "values from multiple folders on a locally running etcd"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd3', 'foo', 'bar', 'baz') }}"

- name: "look for a key prefix"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd3', '/foo/bar', prefix=True) }}"

- name: "connect to etcd3 with a client certificate"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd3', 'foo/bar', cert_cert='/etc/ssl/etcd/client.pem', cert_key='/etc/ssl/etcd/client.key') }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого поиска:

Ключ		Возвращаемое значение	Описание
_raw список / элементы=словарь		успешно	Список ключей и соответствующих значений.
	key строка	успешно	Ключ элемента.
	value строка	успешно	Значение элемента.

Авторы

Eric Belhomme (@eric-belhomme) <ebelhomme@fr.scc.com>

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/etcd3_lookup.html