Role Detail


GlusterFS installation for Linux.
Type Ansible
Minimum Ansible Version 2.0
Installation $ ansible-galaxy install geerlingguy.glusterfs
Last Commit 2017-09-07 03:17:03 AM UTC
Last Imported 2017-11-18 04:18:04 AM UTC
Version History
Version Release Date
2.2.0 2017-09-07 03:17:03 AM
2.1.0 2016-07-20 17:07:05 PM
2.0.0 2016-07-15 19:37:07 PM
1.1.0 2016-03-21 15:03:03 PM
1.0.5 2016-02-15 03:21:03 AM
1.0.3 2015-11-24 18:07:06 PM
1.0.2 2015-07-28 01:41:01 AM
1.0.1 2015-02-24 15:53:03 PM
1.0.0 2015-02-24 14:37:02 PM
0.9.0 2014-11-03 17:26:05 PM
Supported Platforms
Platform Version
Debian jessie
Debian stretch
Debian wheezy
EL 6
EL 7
Ubuntu trusty
Ubuntu xenial
Last 10 Imports
Completed Status
2017-11-18 04:18:04 AM UTC SUCCESS
2017-11-11 04:18:04 AM UTC SUCCESS
2017-11-04 04:18:04 AM UTC SUCCESS
2017-10-28 04:17:04 AM UTC SUCCESS
2017-10-21 04:16:04 AM UTC SUCCESS
2017-10-14 04:19:04 AM UTC SUCCESS
2017-10-08 17:04:05 PM UTC SUCCESS
2017-10-08 16:14:04 PM UTC SUCCESS
2017-10-08 16:13:04 PM UTC SUCCESS
2017-10-07 04:15:04 AM UTC SUCCESS

Ansible Role: GlusterFS

Build Status

Installs and configures GlusterFS on Linux.


For GlusterFS to connect between servers, TCP ports 24007, 24008, and 24009/49152+ (that port, plus an additional incremented port for each additional server in the cluster; the latter if GlusterFS is version 3.4+), and TCP/UDP port 111 must be open. You can open these using whatever firewall you wish (this can easily be configured using the geerlingguy.firewall role).

This role performs basic installation and setup of Gluster, but it does not configure or mount bricks (volumes), since that step is easier to do in a series of plays in your own playbook. Ansible 1.9+ includes the gluster_volume module to ease the management of Gluster volumes.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

glusterfs_default_release: ""

You can specify a default_release for apt on Debian/Ubuntu by overriding this variable. This is helpful if you need a different package or version for the main GlusterFS packages (e.g. GlusterFS 3.5.x instead of 3.2.x with the wheezy-backports default release on Debian Wheezy).

glusterfs_ppa_use: yes
glusterfs_ppa_version: "3.8"

For Ubuntu, specify whether to use the official Gluster PPA, and which version of the PPA to use. See Gluster's Getting Started Guide for more info.



Example Playbook

- hosts: server
    - geerlingguy.glusterfs

For a real-world use example, read through Simple GlusterFS Setup with Ansible, a blog post by this role's author, which is included in Chapter 8 of Ansible for DevOps.



Author Information

This role was created in 2015 by Jeff Geerling, author of Ansible for DevOps.