Skip to content

Ansible role to enable a Gluster cluster with gluster-specific features like samba, ganesha etc.

License

Notifications You must be signed in to change notification settings

sac/gluster-ansible-features

 
 

Repository files navigation

gluster.features

The gluster.features role implements GlusterFS usecases. This role implements following sub-roles:

  • nfs_ganesha
  • gluster_hc
  • ctdb
  • geo_replication

Requirements

  • GlusterFS

Role Variables

NFS Ganesha related variables

Name Choices Default value Comments
gluster_features_ganesha_haname UNDEF Name of the NFS Ganesha cluster.
gluster_features_ganesha_volume UNDEF An existing GlusterFS volume which will be exported through NFS Ganesha
gluster_features_ganesha_hostnames UNDEF A comma separated list of hostnames, these are subset of nodes of the Gluster Trusted Pool that form the ganesha HA cluster
gluster_features_ganesha_viplist UNDEF public A comma separated list of virtual IPs for each of the nodes specified above.
gluster_features_ganesha_masternode UNDEF One of the nodes from the Trusted Storage Pool, gluster commands will be run on this node. gluster_features_ganesha_masternode: "{{ groups['ganesha_nodes'][0] }}" - the first node of the inventory section ganesha_nodes will be used.
gluster_features_ganesha_clusternodes UNDEF List of the nodes in the Trusted Storage Pool. gluster_features_ganesha_clusternodes: "{{ groups['ganesha_nodes'] }}" - The nodes listed in section ganesha_nodes in the inventory.

Gluster Hyperconverged Interface setup related roles

Name Choices Default value Comments
gluster_features_hci_cluster UNDEF The cluster ip/hostnames. Can be set by gluster_hci_cluster: "{{ groups['hc-nodes'] }}", where hc-nodes is from the inventory file.
gluster_features_hci_volumes UNDEF This is a dictionary setting the volume information. See below for further explanation and variables.
gluster_features_hci_volume_options UNDEF This is not needed to be set by user, defaults are picked up. Set to override defaults. For default values see Gluster HCI documentation.
gluster_features_hci_master UNDEF The REST host to be connected to (do not include `http'). This value will be ignored if glusterd1 is running on remote node.
gluster_features_hci_port 24007 The glusterd2 port

Dependencies

gluster.infra gluster.cluster

Example Playbook

Creating a NFS Ganesha Cluster:

An example playbook to deploy NFS Ganesha. Note to gather_facts should be set to true.

---
- name: Setting NFS Ganesha
  remote_user: root
  hosts: ganesha_nodes
  gather_facts: false

  vars:
     # Setting up NFS Ganesha
     gluster_features_ganesha_haname: ganesha-ha
     gluster_features_ganesha_volume: nfs_ganesha
     gluster_features_ganesha_hostnames: "server1,server2,server3,server4"
     gluster_features_ganesha_viplist: 10.70.44.121,10.70.44.122,10.70.44.123,10.70.44.124

     gluster_features_ganesha_masternode: "{{ groups['ganesha_nodes'][0] }}"
     gluster_features_ganesha_clusternodes: "{{ groups['ganesha_nodes'] }}"

  roles:
     - gluster.features

The above playbook assumes that a volume named nfs_ganesha is created and running.

Note:

If you are using GlusterFS 4.0 (glusterd2) ensure to install python-gluster-mgmt-client package on the remote master host.

Or create a directory glusterapilib on the remote host and copy the files volume.py, peer.py, common.py,init.py, excpetions.py under glusterapilib in a python searchable path.

License

GPLv3

Author Information

Sachidananda Urs surs@redhat.com

About

Ansible role to enable a Gluster cluster with gluster-specific features like samba, ganesha etc.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%