{"id":19189269,"url":"https://github.com/plexinc/cookbook-glusterfs","last_synced_at":"2026-06-03T16:31:13.885Z","repository":{"id":138044550,"uuid":"172928716","full_name":"plexinc/cookbook-glusterfs","owner":"plexinc","description":"Glusterfs FS cookbook (forked from https://gitlab.com/s4m-chef-repositories/glusterfs)","archived":false,"fork":false,"pushed_at":"2019-02-27T14:18:37.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2025-02-23T03:43:48.428Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plexinc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-27T14:17:45.000Z","updated_at":"2019-02-27T14:18:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"e1be5c86-e7e7-4b9d-a6b3-e8e19d37c2db","html_url":"https://github.com/plexinc/cookbook-glusterfs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/plexinc/cookbook-glusterfs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plexinc%2Fcookbook-glusterfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plexinc%2Fcookbook-glusterfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plexinc%2Fcookbook-glusterfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plexinc%2Fcookbook-glusterfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plexinc","download_url":"https://codeload.github.com/plexinc/cookbook-glusterfs/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plexinc%2Fcookbook-glusterfs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33874679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-11-09T11:28:50.534Z","updated_at":"2026-06-03T16:31:13.872Z","avatar_url":"https://github.com/plexinc.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"GlusterFS\n=========\n\nDescription\n-----------\n\nGlusterFS is a scalable network filesystem. Using common off-the-shelf\nhardware, you can create large, distributed storage solutions for media\nstreaming, data analysis, and other data- and bandwidth-intensive tasks.\nGlusterFS is free and open source software.\n\nThis cookbook focuses on deploying a GlusterFS cluster via Chef.\n\nRequirements\n------------\n\n### Cookbooks and gems\n\nDeclared in [metadata.rb](metadata.rb) and in [Gemfile](Gemfile).\n\n### Platforms\n\nA *systemd* managed distribution:\n- RHEL Family 7, tested on Centos 7.2\n\nUsage\n-----\n\n### Easy Setup\n\nSet `node['glusterfs']['hosts']` to an array containing the hostnames of\nthe nodes of the GlusterFS cluster.\n\n### Search\n\nThe recommended way to use this cookbook is through the creation of a role\nper **glusterfs** cluster. This enables the search by role feature, allowing a\nsimple service discovery.\n\nIn fact, there are two ways to configure the search:\n1. with a static configuration through a list of hostnames (attributes `hosts`\n   that is `['glusterfs']['hosts']`)\n2. with a real search, performed on a role (attributes `role` and `size`\n   like in `['glusterfs']['role']`). The role should be in the run-list\n   of all nodes of the cluster. The size is a safety and should be the number\n   of nodes in the cluster.\n\nIf hosts is configured, `role` and `size` are ignored\n\nSee [roles](test/integration/roles) for some examples and\n[Cluster Search][cluster-search] documentation for more information.\n\n### Test\n\nThis cookbook is fully tested through the installation of a working 3-nodes\ncluster in docker hosts. This uses kitchen (\u003e= 1.5.0), docker (\u003e= 1.10) and\na small monkey-patch.\n\nAt the moment, the docker images are run in privileged mode which is highly\ninsecure. This is needed by GlusterFS to mount volumes. You are invited to\ncheck the image used (sbernard/centos-systemd-kitchen) for the tests before\nrunning them.\n\nFor more information, see *.kitchen.yml* and *test* directory.\n\nAttributes\n----------\n\nConfiguration is done by overriding default attributes. All configuration keys\nhave a default defined in [attributes/default.rb](attributes/default.rb).\nPlease read it to have a comprehensive view of what and how you can configure\nthis cookbook behavior.\n\nRecipes\n-------\n\n* default\n* repository (setup yum repositories)\n* package (install glusterfs-server)\n* service (make sure glusterd service is enabled and started)\n* configure (probe an host into the cluster and create a volume)\n* client (mount a glusterfs volume)\n\n### Setting Up Clients\n\nPermit access to GlusterFS volumes using Gluster Native Client method\n\n#### Example\n\n```json\n\"glusterfs\": {\n  \"mounts\": {\n    \"myvol\": {\n      \"mount_point\": \"/mnt/data\",\n      \"server\": \"host1.example\"\n    }\n  }\n}\n```\n\nIt creates a mount point on the local filesystem at /mnt/data\nusing GlusterFS fuse client.\n\nResources/Providers\n-------------------\n\n### Probe\n\nProbe an host into the GlusterFS cluster.\n\n#### Example\n\n```ruby\nglusterfs_probe 'my-custom-host.test'\n```\n\n### Volume\n\nCreate a GlusterFS volume\n\n#### Example\n\n##### Creation of a replicated volume with two storage servers\n\n```json\n\"glusterfs\": {\n  \"volumes\": {\n    \"myvol\": {\n      \"type\": \"replica\",\n      \"count\": 2,\n      \"transport_type\": \"tcp\",\n      \"mount_points\": [[\n        \"host1.example:/mnt/brick1\",\n        \"host2.example:/mnt/brick2\",\n      ]],\n      \"action\": [[\"create\", \"start\"]]\n    }\n  }\n}\n\n```\n\nChangelog\n---------\n\nAvailable in [CHANGELOG.md](CHANGELOG).\n\nContributing\n------------\n\nPlease read carefully [CONTRIBUTING.md](CONTRIBUTING.md) before making a merge\nrequest.\n\nLicense and Author\n------------------\n\n- Author:: Samuel Bernard (\u003csamuel.bernard@s4m.io\u003e)\n- Author:: Florian Philippon (\u003cflorian.philippon@s4m.io\u003e)\n\n```text\nCopyright (c) 2016 Sam4Mobile\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplexinc%2Fcookbook-glusterfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplexinc%2Fcookbook-glusterfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplexinc%2Fcookbook-glusterfs/lists"}