PKR-Lab

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)
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