gluster_volume – Manage GlusterFS volumes
Synopsis
- Create, remove, start, stop and tune GlusterFS volumes
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
arbiters - added in 2.3 | Arbiter count for volume. | |
bricks - | Brick paths on servers. Multiple brick paths can be separated by commas. aliases: brick | |
cluster - | List of hosts to use for probing and brick setup. | |
directory - | Directory for limit-usage. | |
disperses - added in 2.2 | Disperse count for volume. | |
force boolean |
| If brick is being created in the root partition, module will fail. Set force to true to override this behaviour. |
host - | Override local hostname (for peer probing purposes). | |
name - / required | The volume name. aliases: volume | |
options - | A dictionary/hash with options/settings for the volume. | |
quota - | Quota value for limit-usage (be sure to use 10.0MB instead of 10MB, see quota list). | |
rebalance boolean |
| Controls whether the cluster is rebalanced after changes. |
redundancies - added in 2.2 | Redundancy count for volume. | |
replicas - | Replica count for volume. | |
start_on_create boolean |
| Controls whether the volume is started after creation or not. |
state - / required |
| Use present/absent ensure if a volume exists or not. Use started/stopped to control its availability. |
stripes - | Stripe count for volume. | |
transport - |
| Transport type for volume. |
Notes
Note
- Requires cli tools for GlusterFS on servers.
- Will add new bricks, but not remove them.
Examples
- name: create gluster volume gluster_volume: state: present name: test1 bricks: /bricks/brick1/g1 rebalance: yes cluster: - 192.0.2.10 - 192.0.2.11 run_once: true - name: tune gluster_volume: state: present name: test1 options: performance.cache-size: 256MB - name: Set multiple options on GlusterFS volume gluster_volume: state: present name: test1 options: { performance.cache-size: 128MB, write-behind: 'off', quick-read: 'on' } - name: start gluster volume gluster_volume: state: started name: test1 - name: limit usage gluster_volume: state: present name: test1 directory: /foo quota: 20.0MB - name: stop gluster volume gluster_volume: state: stopped name: test1 - name: remove gluster volume gluster_volume: state: absent name: test1 - name: create gluster volume with multiple bricks gluster_volume: state: present name: test2 bricks: /bricks/brick1/g2,/bricks/brick2/g2 cluster: - 192.0.2.10 - 192.0.2.11 run_once: true - name: Remove the bricks from gluster volume gluster_volume: state: present name: testvol bricks: /bricks/brick1/b1,/bricks/brick2/b2 cluster: - 10.70.42.85 force: true run_once: true - name: Reduce cluster configuration gluster_volume: state: present name: testvol bricks: /bricks/brick3/b1,/bricks/brick4/b2 replicas: 2 cluster: - 10.70.42.85 force: true run_once: true
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Taneli Leppä (@rosmo)
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.8/modules/gluster_volume_module.html