Installation
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-operator/installation.md
Installation
Code: capulus-operator, Chart: argocd/apps/tech/capulus-operator
Voraussetzungen
| Voraussetzung | Wofür | Prüfen |
|---|---|---|
Namespace capulus-operator in argocd_platform_apps (capulus-ansible) |
ArgoCD legt die Application und den Namespace an | argocd/bootstrap/projects.yaml enthält den Namespace |
Pull-Secret ghcr-pull im Namespace capulus-operator |
das Image liegt in einem privaten GHCR-Package | kubectl -n capulus-operator get secret ghcr-pull |
Image ghcr.io/pkr-lab/capulus-operator:sha-<commit> |
Workflow build-image.yml baut es bei jeder Änderung an Code oder Dockerfile |
Tag in values.yaml unter image.tag |
| VictoriaMetrics-Operator | VMServiceScrape und VMRule |
läuft im Namespace monitoring |
Schritt für Schritt
1. Image bauen lassen
Nach dem Merge nach main baut build-image.yml das Image und pusht sha-<commit>. Den Tag in argocd/apps/tech/capulus-operator/values.yaml unter image.tag eintragen. Ein Tag, den es in GHCR nicht gibt, endet im Pod in ImagePullBackOff.
2. Pull-Secret anlegen
kubectl create namespace capulus-operator
kubectl -n capulus-operator create secret docker-registry ghcr-pull \
--docker-server=ghcr.io --docker-username=<user> --docker-password=<pat>
3. Operator ausrollen
capulus-ansible: make render-bootstrap CORE_DIR=<Pfad zu capulus-core> erzeugt argocd/bootstrap/projects.yaml neu. Nach dem Merge legt ArgoCD die Application capulus-operator an. Sie bleibt auf InvalidSpecError ("do not match any of the allowed destinations in project 'tech'"), bis das AppProject im Cluster angewendet ist, denn projects.yaml rollt nicht ArgoCD aus, sondern die Rolle argocd:
ssh homeserver 'sudo kubectl diff -f -' < argocd/bootstrap/projects.yaml
ssh homeserver 'sudo kubectl apply -f -' < argocd/bootstrap/projects.yaml
ssh homeserver 'sudo kubectl -n argocd annotate application capulus-operator argocd.argoproj.io/refresh=hard --overwrite'
Das Chart bringt die CRDs aus crds/ mit.
4. Verifizieren
kubectl -n capulus-operator get pods
kubectl get crd | grep capulus.homeserver
kubectl -n capulus-operator logs deploy/capulus-operator | tail
Erwartet: Pod Running, vier CRDs, im Log Starting workers ohne error.
Reihenfolge bei der Umstellung eines Backups
Der Operator muss laufen, bevor ein bestehender Backup-CronJob eines Charts durch eine Backup-Ressource ersetzt wird. Sonst fehlt zwischen dem Prune des alten CronJobs und dem ersten Abgleich durch den Operator eine Sicherung. Für Vaultwarden heißt das: erst capulus-operator mergen und prüfen, dann die Umstellung im Chart vaultwarden.