capulus-ansible
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/index.md
capulus-ansible
Ansible-Playbooks und Rollen, die das Capulus-Homelab provisionieren: gehärtete Ubuntu-Hosts, drei k3s-Cluster (TECH, PROD, ENTW), KVM-VMs, Kiosk-Geräte (Raspberry Pi, Banana Pi) und die Host-Dienste (Tailscale, DNS, Power-Management, Watchdogs, Drucker). Die Workloads im Cluster rollt ArgoCD aus capulus-core aus.
Repository: pkr-lab/capulus-ansible
Überblick
| Bereich | Inhalt |
|---|---|
| Playbooks | site.yml (Homeserver/TECH), controlplane-1.yml, worker-1.yml, prod.yml, entw.yml, Kiosk-Playbooks, alert-caller.yml, vaultwarden-restore.yml, render-bootstrap.yml |
| Rollen | 33 Rollen nach dem Prinzip „eine Rolle pro Aufgabe“, siehe Rollen |
| Inventory | inventory/hosts.yml mit den Gruppen homeservers, k3s_agents, prod, entw, semaphore_targets, xibo_displays, banana_pis, alert_callers, alert_caller_pi |
| Variablen | group_vars/ und host_vars/<host>/{vars,vault}.yml; Secrets als !vault-Werte |
| Bedienung | Makefile mit einem Target je Rolle bzw. Playbook (make help) |
Architektur
flowchart TD
op["Betreiber: make install"] --> site["site.yml"]
site --> tech["homeserver: OS, k3s, ArgoCD-Hub, Dienste"]
w["controlplane-1.yml / worker-1.yml"] --> agents["Worker: k3s-Agent, Watchdogs"]
prod["prod.yml"] --> pvm["prod-vm: k3s"]
entw["entw.yml"] --> evm["entw-vm: k3s + ArgoCD"]
kiosk["Kiosk-Playbooks"] --> pis["Raspberry Pi, Banana Pi, Xibo-Display"]
tech --> hub["ArgoCD-Hub liest capulus-core"]
evm --> eargo["ArgoCD ENTW liest Branch entw"]
sem["Semaphore (im Cluster)"] -->|"git pull + ansible-playbook"| site
Zwei Wege führen Änderungen auf die Systeme: Ansible für alles auf den Hosts (Betriebssystem, k3s, Dienste außerhalb Kubernetes), GitOps über ArgoCD für alles in den Clustern. Die Rolle argocd verbindet beides: Sie installiert ArgoCD und legt das Bootstrap-ApplicationSet an, das capulus-core liest.
Der Gesamtüberblick über Hardware, Cluster und Schichten steht in a0010 Architektur-Überblick.
Beziehung zu den anderen Repos
| Richtung | Was | Wie gepinnt |
|---|---|---|
| capulus-ansible → capulus-core | make render-bootstrap CORE_DIR=… schreibt argocd/bootstrap/root-applicationset.yaml und projects.yaml aus den Templates der Rolle argocd |
explizit per Parameter |
| capulus-core → capulus-ansible | Rolle alert_caller lädt caller.py und zwei Patches aus einem capulus-core-Tag |
alert_caller_core_ref plus SHA-256 je Datei |
| capulus-core → capulus-ansible | Root-CA für vier Rollen | Kopie in files/homeserver-root-ca.pem, CI vergleicht mit pki/ in capulus-core |
Seiten
- Installation
- Konfiguration
- Nutzung
- Releases
- Rollen (je Rolle mit Fehlersuche, Übersicht)
- Zentrale Fehlersuche
- Bestehende Fachdokumentation: a-betriebssystem, Rollen-Hintergründe, Semaphore, Power-Manager, nächtliches Worker-Update, Drucker, Hardware-Monitoring, Vereinsheim-Alarmmonitor, CrowdSec, Secrets-Verschlüsselung und Audit-Log