etcd3 – Установка или удаление пар ключ-значение из кластера etcd3
Новое в версии 2.5.
Описание
- Установка или удаление значений в кластере etcd3, используя его API v3.
- Требуется библиотека python etcd3 для работы.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- etcd3
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ca_cert - добавлено в 2.8 | Удостоверяющий центр (Certificate Authority), используемый для проверки узла 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. [сообщество]
Авторы
- 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.9/modules/etcd3_module.html
