Модуль community.general.znode — создание, удаление, получение и обновление znodes с помощью ZooKeeper

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.znode.

Краткое описание
Требования
Параметры
Атрибуты
Примеры

Краткое описание

Создание, удаление, получение и обновление znodes с помощью ZooKeeper.

Требования

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

kazoo >= 2.1

Параметры

Параметр	Комментарии
auth_credential string добавлено в community.general 5.8.0	Значение учетных данных для аутентификации. Зависит от `auth_scheme`. Формат для `auth_scheme=digest` — `user:password`, а формат для `auth_scheme=sasl` — `user:password`.
auth_scheme string добавлено в community.general 5.8.0	Схема аутентификации. Варианты: `"digest"` ← (по умолчанию) `"sasl"`
hosts string / обязательный	Список серверов ZooKeeper (формат `[server]:[port]`).
name string / обязательный	Путь к znode.
op string	Выполняемая операция. Взаимоисключающий параметр по отношению к state. Варианты: `"get"` `"wait"` `"list"`
recursive boolean	Рекурсивно удалить узел и всех его потомков. Варианты: `false` ← (по умолчанию) `true`
state string	Состояние, которое необходимо обеспечить. Взаимоисключающий параметр по отношению к op. Варианты: `"present"` `"absent"`
timeout integer	Время ожидания появления узла. По умолчанию: `300`
use_tls boolean добавлено в community.general 6.5.0	Использовать TLS/SSL или нет. Варианты: `false` ← (по умолчанию) `true`
value string	Значение, присваиваемое znode.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Можно запускать в режиме `check_mode` и возвращать прогноз изменения статуса без изменения целевого объекта.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения о том, что изменилось (или, возможно, требует изменения в `check_mode`).

Примеры

- name: Creating or updating a znode with a given value
  community.general.znode:
    hosts: 'localhost:2181'
    name: /mypath
    value: myvalue
    state: present

- name: Getting the value and stat structure for a znode
  community.general.znode:
    hosts: 'localhost:2181'
    name: /mypath
    op: get

- name: Getting the value and stat structure for a znode using digest authentication
  community.general.znode:
    hosts: 'localhost:2181'
    auth_credential: 'user1:s3cr3t'
    name: /secretmypath
    op: get

- name: Listing a particular znode's children
  community.general.znode:
    hosts: 'localhost:2181'
    name: /zookeeper
    op: list

- name: Waiting 20 seconds for a znode to appear at path /mypath
  community.general.znode:
    hosts: 'localhost:2181'
    name: /mypath
    op: wait
    timeout: 20

- name: Deleting a znode at path /mypath
  community.general.znode:
    hosts: 'localhost:2181'
    name: /mypath
    state: absent

- name: Creating or updating a znode with a given value on a remote Zookeeper
  community.general.znode:
    hosts: 'my-zookeeper-node:2181'
    name: /mypath
    value: myvalue
    state: present
  delegate_to: 127.0.0.1

Авторы

Trey Perry (@treyperry)

Ссылки на коллекцию

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