etcd3 – Установка или удаление пар ключ-значение в кластере etcd3
Новая версия 2.5.
Обзор
- Устанавливает или удаляет значения в кластере etcd3, используя его API v3.
- Требуется библиотека python etcd3 для работы.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- etcd3
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ca_cert - Добавлен в 2.8 | Удостоверяющий центр, используемый для проверки узла etcd. Требуется, если определены client_cert и client_key. | |
| client_cert - Добавлен в 2.8 | Файл цепочки сертификатов в формате PEM, используемый для проверки клиента SSL. Требуется, если определен client_key. | |
| client_key - Добавлен в 2.8 | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для проверки клиента SSL. Требуется, если определен client_cert. | |
| host - | По умолчанию: "localhost" | IP-адрес кластера |
| key - / обязательно | Ключ, в котором хранится информация в кластере | |
| password - Добавлен в 2.8 | Пароль, используемый для аутентификации. Требуется, если определен user. | |
| port - | По умолчанию: 2379 | Номер порта, используемый для подключения к кластеру |
| state - / обязательно | Состояние значения для ключа. Может быть присутствующим или отсутствующим | |
| timeout - Добавлен в 2.8 | Таймаут уровня сокета в секундах. | |
| user - Добавлен в 2.8 | Пользователь etcd для аутентификации. | |
| value - / обязательно | Хранимая информация |
Примеры
# Store a value "bar" under the key "foo" for a cluster located "http://localhost:2379"
- etcd3:
key: "foo"
value: "baz3"
host: "localhost"
port: 2379
state: "present"
# Authenticate using user/password combination with a timeout of 10 seconds
- etcd3:
key: "foo"
value: "baz3"
state: "present"
user: "someone"
password: "password123"
timeout: 10
# Authenticate using TLS certificates
- 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 строка | всегда | Предыдущее значение в кластере |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Jean-Philippe Evrard (@evrardjp)
- Victor Fauth (@vfauth)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/etcd3_module.html
