PKR-Lab

capulus-operator

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-operator/index.md

capulus-operator

Kubernetes-Operator des Capulus-Homelabs. Er ersetzt kopierte CronJobs, Skripte und manuelle Abläufe durch deklarative Ressourcen: Ein Eintrag im Git-Repo beschreibt den Soll-Zustand, der Operator setzt ihn im Cluster um und meldet den Ist-Zustand zurück.

Repository: pkr-lab/capulus-operator. Ausgerollt wird er wie jede andere App über ArgoCD aus capulus-core (Chart argocd/apps/tech/capulus-operator), Hintergründe und Fallstricke stehen in 600c0.


Einordnung

flowchart LR
    git["capulus-core (Git)"] -->|"ArgoCD"| cr["Backup (Custom Resource)"]
    cr --> op["capulus-operator"]
    op -->|"erzeugt und gleicht ab"| cj["CronJob"]
    cj --> job["Job: stage → restic"]
    job --> repo["restic-Repository (PVC)"]
    op -->|"Status, Metriken"| cr
    op -->|"/metrics"| vm["VictoriaMetrics, Alerts"]

Pro Cluster läuft eine eigene Instanz. Aktuell ist der TECH-Cluster ausgerollt.


Stand

Bereich Ressource Controller
Backups (restic, SQLite, Postgres) Backup fertig
Datenbanken (CloudNativePG ansteuern) Database geplant
Zertifikate / PKI ManagedCertificate geplant
Token- und Secret-Rotation (Änderung per Pull Request) SecretRotation geplant

Die Ressourcen der geplanten Bereiche sind Entwürfe. Ihr Schema kann sich ändern, solange kein Controller sie verarbeitet.


Seiten

Seite Inhalt
Installation Deployment, Reihenfolge, Pull-Secret
Konfiguration Flags, Chart-Values, Backup-Spec
Nutzung Backup anlegen, Status, Metriken, Alerts, Wiederherstellung, Fehlersuche
Releases Versionierung und Image-Build