gluster_volume – Manage GlusterFS volumes
Synopsis
- Create, remove, start, stop and tune GlusterFS volumes
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
arbiters
-
|
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
-
|
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
-
|
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.9/modules/gluster_volume_module.html