This repository provides material to get hands on experience with Quobyte.
With material collected here you will be able to try out things like maintenance tasks, see how Quobyte reacts to hardware failures or how you can scale out a Quobyte storage system.
This repository does not contain the official documentation but contains step by step tutorials on how to get specific things done.
This 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 cluster simply change into that directory and follow the numbered instructions there.
Or you simply follow the first three chapters in order:
- 01_preflight check, if Terraform and Ansible are working like expected.
- 02_first_cluster on how to set up a Quobyte system.
- 03_trending. This chapter will help to set up a Prometheus trending server to monitor metrics from your Quobyte cluster, store them over time and make them accessible as graphs.
These three steps give you a valid base setup to perform any other steps mentioned in any other chapter.
For the sake of keeping things easy and repeatable some tools are used throughout the tutorials here:
-
Terraform If 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).
-
Ansible To 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.
-
Scale out a Quobyte cluster without downtime
-
Exchange "hardware" (in our case virtual machines)
-
Upgrade Quobyte
- Upgrade clients
- Upgrade services
-
See disks failing and quobyte acting on that
-
See machines failing and Quobyte reacting on such an event
-
See how Quobyte reacts on network failures
-
See how Quobyte reacts on slow devices
Although this is a pure practical guide, you will learn about concepts like
-
Failure domains
-
File placement policies and their consequences
-
File layout policies and their consequences
and maybe many more.
For now these tutorials are tested only on Google Cloud.
But orchestration tools and deployment tools are not vendor specific.
For instastructure orchestration the tool of choice is terraform.
For installing things Ansible is used.
The Quobyte architectural whitepaper could be useful for concepts, buzzwords and a general understanding of what the hell you are doing here:
https://www.quobyte.com/downloads/quobyte-architecture_whitepaper.pdf
Many topics mentioned here are explained in depth in our recent online reference.