geerlingguy.glusterfs

Ansible Role: GlusterFS

This role installs and sets up GlusterFS on Linux systems.

Requirements

To allow GlusterFS to work across different servers, make sure the following TCP ports are open: 24007, 24008, and 24009 or 49152 onward (you need one additional port for each server if you are using GlusterFS version 3.4 or newer). Also, make sure TCP/UDP port 111 is open. You can open these ports using any firewall you prefer (using the geerlingguy.firewall role is an easy option).

This role handles the basic installation and configuration of GlusterFS, but it does not set up or mount storage volumes (known as bricks). Doing that is simpler within your own playbook. Ansible 1.9 and later versions include the gluster_volume module, which helps manage GlusterFS volumes.

Role Variables

You can configure the following variables, which have default values (see defaults/main.yml):

glusterfs_default_release: ""

You can set a default release for apt on Debian/Ubuntu by changing this variable. This is useful if you want a specific package version for GlusterFS (like GlusterFS 3.5.x instead of 3.2.x on Debian Wheezy).

glusterfs_ppa_use: true
glusterfs_ppa_version: "LATEST"

For Ubuntu, you can choose to use the official Gluster PPA (Personal Package Archive) and specify which version to use. Check out Gluster's Getting Started Guide for more details.

glusterfs_gpg_key_version: "7"
glusterfs_deb_version: "LATEST"

For Debian, you can specify the version of the GPG key and the apt repository to use. More information is available in Gluster's Getting Started Guide.

Dependencies

There are no prerequisites for this role.

Example Playbook

- hosts: server
  roles:
    - geerlingguy.glusterfs

For a real-world example, check out Simple GlusterFS Setup with Ansible, a blog post by the role's author, featured in Chapter 8 of Ansible for DevOps.