f0000 - Argo Workflows (private CI/CD)
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/f-cicd-automatisierung/f0000-argo-workflows.md
Argo Workflows (private CI/CD)
Argo Workflows läuft als
ArgoCD-verwaltete App (argocd/apps/tech/argo-workflows/) und ist die private
CI-Engine des Home-Servers. Es ist mit einer kleinen Garage-Instanz
(argocd/apps/tech/garage/, 300p0) gekoppelt,
die als S3-kompatibles Artifact-Repository und Log-Archiv dient (bis 2026-11 MinIO).
Aufgabenteilung:
Argo Workflows = CI (clonen, testen, linten, Images bauen)
ArgoCD = CD (argocd/apps/* in den Cluster deployen)
- Trigger: manuell über die UI oder
argo submit, plus
CronWorkflow-Schedules. Es gibt keinen öffentlichen Ingress, Git-Webhooks
sind daher außerhalb des Scopes. - Auth: Server-Auth-Mode — kein Login, offen im LAN/Tailnet (gleiches
Trust-Modell wie Grafana/Headlamp/Semaphore). Nur über Tailnet/LAN
erreichbar. - Image-Builds: laufen nicht mehr in Argo Workflows, sondern über
.github/workflows/build-images.yml(f0060). Das frühere WorkflowTemplatekaniko-build-pushist entfernt (Kaniko ist archiviert). Keine In-Cluster-Registry.
| Dienst | URL | Hinweise |
|---|---|---|
| Argo Workflows | http://argo-workflows.tech.homeserver | UI + API (Server-Auth-Mode) |
Garage hat keine Weboberfläche, die S3-API ist nur cluster-intern erreichbar
(garage.garage.svc.cluster.local:3900, Region garage).
1. Einmalige Secrets (kubeseal)
Die beiden Apps liefern SealedSecret-Manifeste mit Platzhalter-Werten
(REPLACE_ME_SEALED_*). Diese müssen gegen den Sealed-Secrets-Controller des
Clusters versiegelt werden, bevor die Apps gesund werden. kubeseal von
einer Maschine mit Cluster-Zugriff ausführen (z.B. per SSH auf dem Server),
gerichtet auf den Controller sealed-secrets-controller im Namespace
sealed-secrets.
Ein wiederverwendbarer Helper:
seal() { # seal <namespace> <secret-name> <value-on-stdin>
kubeseal --raw --namespace "$1" --name "$2" \
--controller-name sealed-secrets-controller \
--controller-namespace sealed-secrets \
--from-file=/dev/stdin
}
1.1 Garage-Schlüssel und Argo-Artifact-S3-Zugriff
Das Skript scripts/seal-garage.sh (capulus-core) erzeugt RPC-Secret, Access-Key-ID (GK…) und
Secret-Key neu, versiegelt sie für garage/garage-secrets und denselben Key für
argo-workflows/argo-artifacts-s3 und schreibt alles in
argocd/apps/tech/garage/values.yaml (secrets.*) und
argocd/apps/tech/argo-workflows/values.yaml (artifactSecret.*):
export KUBECONFIG=~/.kube/homeserver.yaml
./scripts/seal-garage.sh
Garage legt Key und Bucket beim Start an. Ein neuer Key ersetzt den alten nicht
(siehe 300p0).
1.3 GHCR-Push-Credentials (Namespace argo-workflows)
Einen GitHub-PAT mit write:packages erstellen, ein Docker-Config-JSON
bauen, dann unter dem Key .dockerconfigjson versiegeln. Einfügen in
ghcrSecret.encryptedDockerConfigJson:
GHCR_USER=pke
GHCR_PAT=ghp_xxx # PAT mit write:packages
AUTH=$(printf '%s:%s' "$GHCR_USER" "$GHCR_PAT" | base64 -w0)
printf '{"auths":{"ghcr.io":{"auth":"%s"}}}' "$AUTH" \
| seal argo-workflows ghcr-push
Wenn Image-Builds noch nicht benötigt werden, stattdessen
ghcrSecret.enabled: false setzen.
Nach dem Einfügen aller Werte: committen + pushen. ArgoCD synct innerhalb von
~3 Minuten; der Sealed-Secrets-Controller entschlüsselt die SealedSecrets zu
echten Secrets und die Garage- und Argo-Pods starten.
2. Verifizieren
SSH="ssh -i ~/.ssh/id_ed25519 [email protected]"
$SSH 'sudo kubectl -n argocd get application garage argo-workflows'
$SSH 'sudo kubectl -n garage get pods'
$SSH 'sudo kubectl -n argo-workflows get pods'
http://argo-workflows.tech.homeserver öffnen — die Workflows-UI sollte
laden und die WorkflowTemplates git-ci und pod-maintenance auflisten.
3. Pipelines ausführen
Die argo-CLI spricht mit dem Server; sie auf dem Host oder einer beliebigen
Tailnet-Maschine mit folgenden Env-Vars ausführen (oder einfach über die UI
submitten):
export ARGO_SERVER=argo-workflows.tech.homeserver:80
export ARGO_HTTP1=true
# server.secure: false in values.yaml → Server spricht nur Klartext-HTTP.
# Ohne dieses Flag versucht die CLI trotzdem TLS und scheitert am
# TLS-Handshake (Traefik antwortet mit dem *internen* Wildcard-Zertifikat,
# das den Bare-Hostnamen nicht abdeckt).
export ARGO_SECURE=false
# k3s-Kubeconfigs (auch /home/ubuntu/.kube/config) authentifizieren per
# Client-TLS-Zertifikat, nicht per Bearer-Token — kubectl kommt damit klar,
# die CLI braucht für die Anfrage an den Argo-Server aber explizit einen
# echten Token. Die im Chart bereits angelegte Workflow-ServiceAccount
# (`argo-workflow`, values.yaml → workflow.serviceAccount.name) dafür
# verwenden:
export ARGO_TOKEN="Bearer $(kubectl -n argo-workflows create token argo-workflow)"
3.1 Test-/Lint-Job (git-ci)
argo submit -n argo-workflows --from workflowtemplate/git-ci \
-p repo=https://github.com/pkr-lab/capulus-core.git \
-p revision=main \
-p image=alpine:3.20 \
-p cmd="ls -la && cat README.md | head"
Das Git-Repo wird als Input-Artifact unter /work ausgecheckt; Step-Logs
werden nach Garage archiviert (Bucket argo-artifacts). Ein Succeeded-Status
mit sichtbaren archivierten Logs bestätigt, dass das Artifact-Repository
korrekt verdrahtet ist.
3.2 Image-Build (entfernt)
Das WorkflowTemplate kaniko-build-push ist am 2026-10-18 entfernt worden. Image-Builds macht .github/workflows/build-images.yml (f0060). Das Secret ghcr-push (Docker-Config für GHCR) wird von nichts mehr genutzt; der zugehörige PAT kann bei GitHub widerrufen werden, das SealedSecret argo-workflows-ghcr-push danach aus dem Chart und dem Token-Register entfernt werden.
3.3 Geplante Runs (CronWorkflow)
nightly-home-server-lint liefert suspendiert aus. cmd auf einen
echten Lint-Befehl in
argocd/apps/tech/argo-workflows/templates/cronworkflow.yaml anpassen, dann
fortsetzen:
argo cron resume -n argo-workflows nightly-home-server-lint
4. Troubleshooting
- App hängt in
Progressing/ Pods mitCreateContainerConfigError—
die SealedSecrets sind noch Platzhalter oder der Controller konnte sie
nicht entschlüsseln. §1 erneut prüfen, mitkubectl -n <ns> get secret <name>verifizieren, dass das Secret existiert. git-ciläuft erfolgreich durch, aber Logs werden nicht archiviert —
die Werte desargo-artifacts-s3-Secrets stimmen nicht mit dem
Garage-Key ingarage-secretsüberein, oder Garage ist nicht erreichbar.
kubectl -n garage logs deploy/garageprüfen (beim Start meldet Garage
angelegten Key und Bucket), Region mussgaragesein.- CRDs beim ersten Sync nicht gefunden — die WorkflowTemplate-/
CronWorkflow-Custom-Resources und die Argo-CRDs landen im selben Sync. Das
ApplicationSet setzt bereitsSkipDryRunOnMissingResource=true+ Retry,
sodass es beim nächsten Reconcile konvergiert; keine manuelle Aktion nötig. - GHCR vom Cluster aus nicht erreichbar — abhängig von der
Egress-Policy. Falls Outbound nachghcr.ioblockiert ist, brauchen
Image-Builds statt dessen eine lokale Registry (separate Änderung: eine
registry:2-App + Containerd-Mirror-Konfiguration in derk3s-Rolle).