community.general.etcd3 – Установка или удаление пар ключ-значение в кластере etcd3

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

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

Для использования в книге задач укажите: community.general.etcd3

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

Обзор

Устанавливает или удаляет значения в кластере etcd3, используя его API версии 3.
Требует работы с библиотекой python etcd3.

Требования

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

etcd3

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ca_cert строка		Удостоверение центра сертификации для проверки узла etcd. Требуется, если определены client_cert и client_key.
client_cert строка		Файл цепочки сертификатов в формате PEM для проверки клиента SSL. Требуется, если определен client_key.
client_key строка		Файл в формате PEM, содержащий ваш закрытый ключ для проверки клиента SSL. Требуется, если определен client_cert.
host строка	Значение по умолчанию: "localhost"	IP-адрес кластера
key строка / обязательно		Ключ, в котором хранится информация в кластере
password строка		Пароль для аутентификации. Требуется, если определен user.
port строка	Значение по умолчанию: 2379	Порт, используемый для подключения к кластеру
state строка / обязательно	Варианты: present absent	Состояние значения для ключа. Может быть present или absent
timeout строка		Таймаут на уровне сокета в секундах.
user строка		Пользователь etcd для аутентификации.
value строка / обязательно		Хранимая информация.

Примеры

- name: Store a value "bar" under the key "foo" for a cluster located "http://localhost:2379"
  community.general.etcd3:
    key: "foo"
    value: "baz3"
    host: "localhost"
    port: 2379
    state: "present"

- name: Authenticate using user/password combination with a timeout of 10 seconds
  community.general.etcd3:
    key: "foo"
    value: "baz3"
    state: "present"
    user: "someone"
    password: "password123"
    timeout: 10

- name: Authenticate using TLS certificates
  community.general.etcd3:
    key: "foo"
    value: "baz3"
    state: "present"
    ca_cert: "/etc/ssl/certs/CA_CERT.pem"
    client_cert: "/etc/ssl/certs/cert.crt"
    client_key: "/etc/ssl/private/key.pem"

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

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

Ключ	Возвращаемое значение	Описание
key строка	всегда	Запрошенный ключ
old_value строка	всегда	Предыдущее значение в кластере

Авторы

Jean-Philippe Evrard (@evrardjp)
Victor Fauth (@vfauth)

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