{"id":19416985,"url":"https://github.com/quobyte/quobyte-in-action","last_synced_at":"2026-03-02T19:34:57.743Z","repository":{"id":86097842,"uuid":"313947745","full_name":"quobyte/quobyte-in-action","owner":"quobyte","description":"Work with Quobyte","archived":false,"fork":false,"pushed_at":"2024-11-29T11:11:16.000Z","size":310,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-01-07T17:17:50.330Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quobyte.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-11-18T13:44:51.000Z","updated_at":"2024-11-29T11:11:20.000Z","dependencies_parsed_at":"2024-11-29T12:20:33.088Z","dependency_job_id":"9c06fecb-644f-484e-a4d1-cd1488bb9de5","html_url":"https://github.com/quobyte/quobyte-in-action","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quobyte%2Fquobyte-in-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quobyte%2Fquobyte-in-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quobyte%2Fquobyte-in-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quobyte%2Fquobyte-in-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quobyte","download_url":"https://codeload.github.com/quobyte/quobyte-in-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240595180,"owners_count":19826335,"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-11-10T13:06:34.690Z","updated_at":"2026-03-02T19:34:52.694Z","avatar_url":"https://github.com/quobyte.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quobyte in action\n\nThis repository provides material to get hands on experience with Quobyte.\n\nWith material collected here you will be able to try out things like maintenance tasks, \nsee how Quobyte reacts to hardware failures or how you can scale out a Quobyte storage system.\n\nThis repository does not contain the [official documentation](https://support.quobyte.com/docs/16/latest/index.html) but contains step by step tutorials on how to get specific things done.\n\n## How to use this repository\n\nThis repository is usually structured in chapters that work on their own. If you are for example interested in how to integrate Quobyte into a Kubernetes \ncluster simply change into that directory and follow the numbered instructions there. \n\nOr you simply follow the first three chapters in order: \n\n* [01_preflight](https://github.com/jan379/quobyte-in-action/tree/main/01_preflight) check, if Terraform and Ansible are working like expected.\n* [02_first_cluster](https://github.com/jan379/quobyte-in-action/tree/main/02_first_cluster) on how to set up a Quobyte system.\n* [03_trending](https://github.com/jan379/quobyte-in-action/tree/main/03_trending). This chapter will help to set up a [Prometheus](https://prometheus.io/) trending server \n to monitor metrics from your Quobyte cluster, store them over time and make them accessible as graphs.\n\nThese three steps give you a valid base setup to perform any other steps mentioned in any other chapter.\n\nFor the sake of keeping things easy and repeatable some tools are used throughout the tutorials here:\n\n1. Terraform\nIf you do not have a lab environment with existing machines available we provide some terraform receipts to set up virtual machines in a cloud environment (Infrastructure as code).\n\n2. Ansible\nTo install software to linux boxes in a convenient way we use Ansible. Ansible is more or less used as a wrapper around official supported tools like the Quobyte installer. If you need to transfer steps done in an Ansible playbook to other automation tools like Saltstack you can use these playbooks as a reference/ inspiration.\n\n\n## Maintenance\n\n* Scale out a Quobyte cluster without downtime\n\n* Exchange \"hardware\" (in our case virtual machines)\n\n* Upgrade Quobyte\n\t* Upgrade clients\n\t* Upgrade services\n\n\n## Operational edge cases\n\n* See disks failing and quobyte acting on that\n\n* See machines failing and Quobyte reacting on such an event\n\n* See how Quobyte reacts on network failures\n\n* See how Quobyte reacts on slow devices\n\n\n## Concepts\n\nAlthough this is a pure practical guide, you will learn about concepts like\n\n* Failure domains\n\n* File placement policies and their consequences\n\n* File layout policies and their consequences\n\nand maybe many more.\n\n## Requirements\n\nFor now these tutorials are tested only on Google Cloud.\n\nBut orchestration tools and deployment tools are not vendor specific.\n\nFor instastructure orchestration the tool of choice is terraform.\n\nFor installing things Ansible is used.\n\n## Literature\n\n### Architecture\n\nThe Quobyte architectural whitepaper could be useful for concepts, \nbuzzwords and a general understanding of what the hell you are doing here: \n\nhttps://www.quobyte.com/downloads/quobyte-architecture_whitepaper.pdf\n\n### Reference\n\nMany topics mentioned here are explained in depth in our recent [online reference](https://support.quobyte.com/docs/16/latest/index.html).\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquobyte%2Fquobyte-in-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquobyte%2Fquobyte-in-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquobyte%2Fquobyte-in-action/lists"}