https://github.com/geerlingguy/ansible-role-glusterfs

Ansible Role - GlusterFS
https://github.com/geerlingguy/ansible-role-glusterfs

ansible file filesystem gluster glusterfs install role server sync

Last synced: 3 months ago
JSON representation

Ansible Role - GlusterFS

• Host: GitHub
• URL: https://github.com/geerlingguy/ansible-role-glusterfs
• Owner: geerlingguy
• License: mit
• Archived: true
• Created: 2014-10-30T19:58:56.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-07-10T22:47:56.000Z (over 1 year ago)
• Last Synced: 2024-08-03T09:05:19.759Z (6 months ago)
• Topics: ansible, file, filesystem, gluster, glusterfs, install, role, server, sync
• Homepage: https://galaxy.ansible.com/geerlingguy/glusterfs/
• Size: 64.5 KB
• Stars: 105
• Watchers: 7
• Forks: 61
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-list-ansible - ansible-role-glusterfs - GlusterFS (server)

README

        
# Ansible Role: GlusterFS

[![CI](https://github.com/geerlingguy/ansible-role-glusterfs/workflows/CI/badge.svg?event=push)](https://github.com/geerlingguy/ansible-role-glusterfs/actions?query=workflow%3ACI)

Installs and configures GlusterFS on Linux.

## Requirements

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`](https://docs.ansible.com/ansible/latest/collections/gluster/gluster/gluster_volume_module.html#ansible-collections-gluster-gluster-gluster-volume-module) 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: true

    glusterfs_ppa_version: "LATEST"

For Ubuntu, specify whether to use the official Gluster PPA, and which version of the PPA to use. See Gluster's [Getting Started Guide](https://docs.gluster.org/en/latest/Install-Guide/Install/) for more info.

    glusterfs_gpg_key_version: "7"

    glusterfs_deb_version: "LATEST"

For Debian, specify the version of the GPG key and apt package repository to use. See Gluster's [Getting Started Guide](https://docs.gluster.org/en/latest/Install-Guide/Install/) for more info.

## Dependencies

None.

## Example Playbook

    - hosts: server

      roles:

        - geerlingguy.glusterfs

For a real-world use example, read through [Simple GlusterFS Setup with Ansible](https://www.jeffgeerling.com/blog/simple-glusterfs-setup-ansible), a blog post by this role's author, which is included in Chapter 8 of [Ansible for DevOps](https://www.ansiblefordevops.com/).

## License

MIT / BSD

## Author Information

This role was created in 2015 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).