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

Примечание

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

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

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

Для использования в playbook укажите: community.general.znode.

Обзор
Требования
Параметры
Атрибуты
Примеры

Обзор

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

Требования

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

kazoo >= 2.1

Параметры

Параметр	Комментарии
auth_credential строка добавлен в community.general 5.8.0	Значение учетных данных аутентификации. Зависит от `auth_scheme`. Формат для `auth_scheme=digest` — `user:password`, а формат для `auth_scheme=sasl` — `user:password`.
auth_scheme строка добавлен в community.general 5.8.0	Схема аутентификации. Варианты: `"digest"` ← (по умолчанию) `"sasl"`
hosts строка / обязательный	Список серверов ZooKeeper (формат ‘[сервер]:[порт]’).
name строка / обязательный	Путь к узлу znode.
op строка	Операция для выполнения. Взаимоисключительно со state. Варианты: `"get"` `"wait"` `"list"`
recursive логическое	Рекурсивное удаление узла и всех его дочерних элементов. Варианты: `false` ← (по умолчанию) `true`
state строка	Состояние для принудительного выполнения. Взаимоисключительно с op. Варианты: `"present"` `"absent"`
timeout целое число	Время ожидания появления узла. По умолчанию: `300`
use_tls логическое добавлен в community.general 6.5.0	Использовать TLS/SSL или нет. Варианты: `false` ← (по умолчанию) `true`
value строка	Значение, присваиваемое узлу 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/znode_module.html