Learn Ceph on your own PC by breaking and fixing a real cluster
Docent is a self-study lab for Ceph. It runs three LXD virtual machines on
your computer, lets you install MicroCeph on them step by step, and shows
what the cluster does as it happens. In fault diagnosis it breaks something
real, checks your fix by itself, and explains the cause when you give up.
Install
sudo snap install docent
sudo bash /snap/docent/current/docent-install.sh
The setup script installs LXD (or uses the one you already have), connects
Docent to it over HTTPS on 127.0.0.1, creates the three VMs while showing
their progress, and prints the web address when they are ready
(http://127.0.0.1:8484). The first run takes 5 to 10 minutes.
Use
docent: print the web address
sudo docent status: web and VM status
sudo docent watch: watch VMs being created
sudo docent destroy, then sudo docent create: start over with new VMs
sudo snap set docent vm-memory=3GiB vm-cpu=2: size of the next VMs
(without vm-cpu, each VM may use every CPU of the computer)
sudo snap remove docent: remove Docent, its VMs and their disks
Where sudo does not look in /snap/bin (Arch, Fedora), type
sudo /snap/bin/docent instead.
Needs
An x86_64 Linux PC with virtualization turned on (/dev/kvm), 16GiB of memory
(less works with smaller VMs) and about 30GiB of free disk.