Stakkr
Stakkr is an Ansible-driven KVM lab scaffold for local OpenShift bring-up, supporting RHEL guests, and host resource policy experiments on one libvirt host.
Quick Start
- Host policy
- OpenShift SNO
- OpenShift compact
- Observer
./scripts/host-resource-management.sh host-resource-management-apply
./scripts/host-resource-management.sh host-memory-oversubscription-apply
./scripts/host-resource-management.sh host-resource-management-status
./scripts/host-resource-management.sh host-memory-oversubscription-status
cp vars/cluster/openshift_install_cluster.yml.example vars/cluster/openshift_install_cluster.yml
cp vars/guests/openshift_cluster_vm.yml.example vars/guests/openshift_cluster_vm.yml
ansible-playbook -i inventory/hosts.yml playbooks/site-openshift-sno.yml --ask-vault-pass --ask-become-pass
cp vars/cluster/openshift_install_cluster.compact.yml.example vars/cluster/openshift_install_cluster.yml
cp vars/guests/openshift_cluster_vm.compact.yml.example vars/guests/openshift_cluster_vm.yml
ansible-playbook -i inventory/hosts.yml playbooks/site-openshift-compact.yml --ask-vault-pass --ask-become-pass
sudo dnf install -y ./cockpit/stakkr-observer/rpmbuild/RPMS/noarch/cockpit-stakkr-observer-1.0.0-1.el10.noarch.rpm
Then open Cockpit and navigate to Stakkr Observer.
Start with Prerequisites before running deploy playbooks. The quick-start commands assume local inventory, secrets, DNS, images, and OpenShift inputs are already in place.
Install And Setup
Stakkr is run from the repository checkout with Ansible and local libvirt tooling. There is no separate binary to install.
git clone https://github.com/turbra/stakkr.git
cd stakkr
ansible-galaxy collection install -r requirements.yml
ansible-inventory -i inventory/hosts.yml --graph
Explore
Getting StartedPrepare local inputs, apply the host foundation, and run the first validation checks.ConceptsUnderstand the operating model, performance domains, host policy layers, and local state.ReferenceScript actions, playbooks, configuration files, generated state, and GitHub Pages deployment.
Main Paths
| Task | Start here |
|---|---|
| Deploy local OpenShift SNO | First SNO Deploy |
| Deploy local OpenShift compact | Compact OpenShift Cluster Scaffold |
| Apply live VM contention policy | Shared Execution Pool With Weighted Performance Domains |
| Bootstrap generic RHEL 10 guests | Generic RHEL 10 VM Bootstrap |
| Bootstrap local IdM | Local IdM Bootstrap |
| Inspect host policy in Cockpit | First Observer Check |
Related
Stakkr borrows ideas from Calabi, but targets local consumer hardware rather than AWS.