https://github.com/stackhpc/ansible-role-gluster-cluster

Lightweight role for deploying a Gluster cluster
https://github.com/stackhpc/ansible-role-gluster-cluster

Last synced: 2 months ago
JSON representation

Lightweight role for deploying a Gluster cluster

• Host: GitHub
• URL: https://github.com/stackhpc/ansible-role-gluster-cluster
• Owner: stackhpc
• License: apache-2.0
• Created: 2018-05-01T14:28:44.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-03T08:03:08.000Z (almost 4 years ago)
• Last Synced: 2024-04-14T22:50:17.071Z (over 2 years ago)
• Homepage:
• Size: 20.5 KB
• Stars: 0
• Watchers: 8
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
Gluster Cluster

===============

This is a lightweight and opinionated role for configuring a Gluster cluster,

serving a single volume and spanning multiple nodes.

The role will attempt to use all hosts active in the play.

Requirements

------------

* Only Centos hosts are currently supported.

* The hosts must be homogeneous with respect to block devices. In particular

  the block devices specified in  ```gluster_cluster_block_devices``` should

  exist in all nodes within the cluster.

Role Variables (required)

-------------------------

* ``gluster_cluster_volume_name``: Name of the Gluster volume to create.

* ``gluster_cluster_block_devices``: List of block devices to create bricks from.

* ``gluster_cluster_transport_interface``: For example: ``ib0``, ``enp0s1``.

* ``gluster_cluster_transport_mode``: Either ``tcp`` or ``rdma``.

Role Variables (optional)

-------------------------

* ``gluster_cluster_hosts``: Defaults to all hosts in the

  ``gluster_cluster_storage_group_name`` group. The hosts which provide the bricks

  for the volume provided by the Gluster cluster.

* ``gluster_cluster_storage_group_name``: Defaults to ``storage``. The Ansible

  group name of storage hosts from the inventory file.

* ``gluster_cluster_volume_options``: A dict of Gluster volume options.

* ``gluster_cluster_volume_base_path``: The base folder in which to store volumes.

* ``gluster_cluster_stripes``: Default to ``0``. See [1].

* ``gluster_cluster_disperses``: Defaults to ``0``. See [1].

* ``gluster_cluster_replicas``: Defaults to ``0``. See [1].

* ``gluster_cluster_redundancies``: Defaults to ``0``. See [1].

[1] https://docs.gluster.org/en/v3/Administrator%20Guide/Setting%20Up%20Volumes/

Dependencies

------------

None

Example Playbook

----------------

The following playbook configures a Gluster volume:

    ---

    - name: Configure Gluster

      hosts: storage

      roles:

        - role: gluster-cluster

          gluster_cluster_volume_name: my_volume

          gluster_cluster_block_devices:

            - sdb

            - sdc

            - sdd

          gluster_cluster_transport_interface: ib0

          gluster_cluster_transport_mode: rdma

          gluster_cluster_volume_options:

            cluster.nufa: 'on'

Author Information

------------------

- Doug Szumski ()