gluster_peer - Attach/Detach peers to/from the cluster
New in version 2.6.
Synopsis
- Create or diminish a GlusterFS trusted storage pool. A set of nodes can be added into an existing trusted storage pool or a new storage pool can be formed. Or, nodes can be removed from an existing trusted storage pool.
Requirements
The below requirements are needed on the host that executes this module.
- GlusterFS > 3.2
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
force bool |
"false" | Applicable only while removing the nodes from the pool. gluster will refuse to detach a node from the pool if any one of the node is down, in such cases force can be used. |
nodes required | List of nodes that have to be probed into the pool. | |
state required |
| Determines whether the nodes should be attached to the pool or removed from the pool. If the state is present, nodes will be attached to the pool. If state is absent, nodes will be detached from the pool. |
Notes
Note
- This module does not support check mode.
Examples
- name: Create a trusted storage pool gluster_peer: state: present nodes: - 10.0.1.5 - 10.0.1.10 - name: Delete a node from the trusted storage pool gluster_peer: state: absent nodes: - 10.0.1.10 - name: Delete a node from the trusted storage pool by force gluster_peer: state: absent nodes: - 10.0.0.1 force: true
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- Sachidananda Urs (@sac)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/gluster_peer_module.html