{"id":14109338,"url":"https://github.com/gluster/gluster-ansible-cluster","last_synced_at":"2025-04-22T21:03:35.979Z","repository":{"id":31979301,"uuid":"128540485","full_name":"gluster/gluster-ansible-cluster","owner":"gluster","description":"Ansible role to create and deploy a Gluster cluster.","archived":false,"fork":false,"pushed_at":"2022-05-05T11:23:19.000Z","size":65,"stargazers_count":41,"open_issues_count":10,"forks_count":25,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-22T21:02:03.911Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gluster.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-07T15:14:39.000Z","updated_at":"2025-01-23T19:53:43.000Z","dependencies_parsed_at":"2022-08-07T17:01:13.412Z","dependency_job_id":null,"html_url":"https://github.com/gluster/gluster-ansible-cluster","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluster%2Fgluster-ansible-cluster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluster%2Fgluster-ansible-cluster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluster%2Fgluster-ansible-cluster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluster%2Fgluster-ansible-cluster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gluster","download_url":"https://codeload.github.com/gluster/gluster-ansible-cluster/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250324682,"owners_count":21411943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-14T10:02:14.762Z","updated_at":"2025-04-22T21:03:35.917Z","avatar_url":"https://github.com/gluster.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"gluster.cluster\n===============\n\nThis role helps the user to set up a GlusterFS cluster, manage gluster volumes and peer operations.\nThe gluster.cluster role has multiple sub-roles which are invoked depending on the variables that are set.\nThe sub-roles are:\n\n  1. gluster_volume - manage gluster volumes(create, delete, start, stop, set)\n  2. gluster_brick - perform add/remove/replace operations on existing bricks\n\nRequirements\n------------\n- Ansible version 2.5 or above.\n- GlusterFS version 3.2 or above.\n\n\nRole Variables\n--------------\n\nThese are the superset of role_varibles. They are explained further in the respective sub-roles directory.\n\n### gluster_volume\n------------------\n\n| Name | Choices | Default value | Comments |\n| --- | --- | --- | --- |\n| gluster_cluster_arbiter_count | | UNDEF | Number of arbiter bricks to use (Only for arbiter volume types). |\n| gluster_cluster_bricks | | UNDEF | Bricks that form the GlusterFS volume. The format of the bricks would be hostname:mountpoint/brick_dir alternatively user can provide just mountpoint/birck_dir, in such a case gluster_hosts variable has to be set |\n| gluster_cluster_disperse_count | | UNDEF | Disperse count for the volume. If this value is specified, a dispersed volume will be  created |\n| gluster_cluster_force | **yes** / **no** | no | Force option will be used while creating a volume, any warnings will be suppressed. |\n| gluster_cluster_hosts | | | Contains the list of hosts that have to be peer probed. |\n| gluster_cluster_redundancy_count | | UNDEF | Specifies the number of redundant bricks while creating a disperse volume. If redundancy count is missing an optimal value is computed. |\n| gluster_cluster_replica_count | **2** / **3** | UNDEF | Replica count while creating a volume. Currently replica 2 and replica 3 are supported. |\n| gluster_cluster_state | **present** / **absent** / **started** / **stopped** / **set** | present | If value is present volume will be created. If value is absent, volume will be deleted. If value is started, volume will be started. If value is stopped, volume will be stopped. |\n| gluster_cluster_transport | **tcp** / **rdma** / **tcp,rdma** | tcp | The transport type for the volume. |\n| gluster_cluster_volume | | glustervol | Name of the volume. Refer GlusterFS documentation for valid characters in a volume name. |\n\n### gluster_brick\n-----------------\n\n| Name | Choices | Default value | Comments |\n| --- | --- | --- | --- |\n| gluster_cluster_new_bricks | | UNDEF | Contains the  list of bricks along with the new bricks to be added to the GlusterFS volume. The format of the bricks is mountpoint/brick_dir |\n| gluster_cluster_hosts | | UNDEF | Contains the list of hosts that have to be peer probed. |\n| gluster_cluster_volume | | glustervol | Name of the volume. Refer GlusterFS documentation for valid characters in a volume name. |\n| gluster_cluster_remove_bricks | | UNDEF | Contains the list of bricks to be removed. |\n\n\n### Example Playbook\n--------------------\n\nCreate a GlusterFS volume and set specific options.\n\n```yaml\n---\n- name: Create Gluster cluster\n  hosts: gluster_servers\n  remote_user: root\n  gather_facts: false\n\n  vars:\n    # gluster volume\n    gluster_cluster_hosts:\n      - 10.70.41.212\n      - 10.70.42.156\n    gluster_cluster_volume: testvol\n    gluster_cluster_transport: 'tcp'\n    gluster_cluster_force: 'yes'\n    gluster_cluster_bricks: '/mnt/brick1/store,/mnt/brick2/store'\n\n    # variables to create specific type of the volume\n    gluster_cluster_replica_count: 2\n\n    # variables to set specific volume options\n    gluster_cluster_options: {'performance.cache-size':'256MB'}\n\n  roles:\n    - gluster.cluster\n\n```\n\nLicense\n-------\n\nGPLv3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgluster%2Fgluster-ansible-cluster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgluster%2Fgluster-ansible-cluster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgluster%2Fgluster-ansible-cluster/lists"}