community.general.znode module – Create, delete, retrieve, and update znodes using ZooKeeper

Note

This module is part of the community.general collection (version 8.5.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: community.general.znode.

Synopsis

  • Create, delete, retrieve, and update znodes using ZooKeeper.

Aliases: clustering.znode

Requirements

The below requirements are needed on the host that executes this module.

  • kazoo >= 2.1

Parameters

Parameter

Comments

auth_credential

string

added in community.general 5.8.0

The authentication credential value. Depends on auth_scheme.

The format for auth_scheme=digest is user:password, and the format for auth_scheme=sasl is user:password.

auth_scheme

string

added in community.general 5.8.0

Authentication scheme.

Choices:

  • "digest" ← (default)

  • "sasl"

hosts

string / required

A list of ZooKeeper servers (format ‘[server]:[port]’).

name

string / required

The path of the znode.

op

string

An operation to perform. Mutually exclusive with state.

Choices:

  • "get"

  • "wait"

  • "list"

recursive

boolean

Recursively delete node and all its children.

Choices:

  • false ← (default)

  • true

state

string

The state to enforce. Mutually exclusive with op.

Choices:

  • "present"

  • "absent"

timeout

integer

The amount of time to wait for a node to appear.

Default: 300

use_tls

boolean

added in community.general 6.5.0

Using TLS/SSL or not.

Choices:

  • false ← (default)

  • true

value

string

The value assigned to the znode.

Attributes

Attribute

Support

Description

check_mode

Support: none

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- 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

Authors

  • Trey Perry (@treyperry)