W3cubDocs

/Ansible

znode - Create, delete, retrieve, and update znodes using ZooKeeper

New in version 2.0.

Synopsis

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

Requirements (on host that executes module)

  • kazoo >= 2.1
  • python >= 2.6

Options

parameter required default choices comments
hosts
yes
A list of ZooKeeper servers (format '[server]:[port]').
name
yes
The path of the znode.
op
no None
An operation to perform. Mutually exclusive with state.
recursive
(added in 2.1)
no
Recursively delete node and all its children.
state
no None
The state to enforce. Mutually exclusive with op.
timeout
no 300
The amount of time to wait for a node to appear.
value
no None
The value assigned to the znode.

Examples

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

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

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

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

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

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

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.

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