W3cubDocs

/Ansible

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

New in version 2.0.

Synopsis

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
- action: znode hosts=localhost:2181 name=/mypath value=myvalue state=present

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

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

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

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

This is an Extras Module

For more information on what this means please read Extras Modules

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

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