PKR-Lab

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