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