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 |