PKR-Lab

600c0 - capulus-operator — Hintergründe

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/6-hintergruende/600c0-capulus-operator.md

capulus-operator — Hintergründe

Der Code von capulus-operator und das Chart argocd/apps/tech/capulus-operator sind kommentarfrei. Dieses Doc hält fest, warum etwas so gebaut ist. Was der Operator tut und wie man ihn bedient: capulus-operator.


Entscheidungen

Fundstelle Begründung
Eigener Go-Operator statt nur bestehende Operatoren Backups, Rotation und PKI haben im Homelab eigene Regeln (Token-Register, SealedSecrets, NAS-Squash), die kein fertiger Operator abbildet. Für Datenbanken steuert der Operator CloudNativePG an, statt Postgres selbst zu betreiben
Eine Instanz pro Cluster ENTW bleibt als Testumgebung isoliert und folgt der Promotion-Kette ENTW → TECH → PROD. Ausgerollt ist bisher TECH
Operator erzeugt einen CronJob, statt selbst zu planen Zeitplan, Zeitzone, concurrencyPolicy: Forbid, Job-Historie und Logs bleiben Kubernetes-Standard und mit kubectl sichtbar. Der Operator gleicht nur den Spec ab und liest den Status zurück
Spec-Hash als Annotation (capulus.homeserver/spec-hash) Ein Vergleich mit dem vom API-Server um Standardwerte ergänzten CronJob wäre immer ungleich und würde bei jedem Abgleich schreiben. Der Hash vergleicht nur, was der Operator selbst erzeugt
Fremder CronJob gleichen Namens wird nicht übernommen Ohne Owner-Referenz auf das Backup verweigert der Operator den Abgleich (Ready=False). Ein versehentlich gleich benannter CronJob wird so nie überschrieben
Status per Status().Patch mit MergeFrom Update lieferte „object has been modified“, weil CronJob-Ereignisse und Status-Schreiben konkurrieren (beim Test gegen einen echten Cluster beobachtet)

Backup

Chart und CI

Reihenfolge der Umstellung

Der Operator läuft zuerst, danach ersetzt ein Chart seinen CronJob durch ein Backup. Sonst prunt ArgoCD den alten CronJob, und bis zum ersten Abgleich gibt es keine Sicherung.