PKR-Lab

Garage — S3-Speicher für Argo Workflows

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/3-apps-workloads/300p0-garage.md

Garage — S3-Speicher für Argo Workflows

Einzelner Garage-Server (Single-Node, eine Replika) als S3-kompatibler Artefaktspeicher und Log-Archiv für Argo Workflows. Löst seit 2026-11 MinIO ab (Gründe: 60040). Für einen kleinen Heim-CI-Bedarf ausgelegt, nicht als hochverfügbarer Objektspeicher.

Cluster: TECH · Ordner argocd/apps/tech/garage/ · S3-API nur cluster-intern garage.garage.svc.cluster.local:3900, keine Weboberfläche. kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster).


Architektur

Teil Wert
Chart eigenes Chart (Deployment, ConfigMap, Service, PVC, SealedSecret), kein Upstream-Chart
Image dxflrs/garage:v2.5.0 (Docker Hub, Renovate bumpt image.tag)
Start garage server --single-node --default-bucket: Layout, Key und Bucket legt der Server beim Start an
Konfiguration ConfigMap garage-config (/etc/garage.toml): replication_factor = 1, Metadaten in SQLite
Speicher PVC garage-data, 10Gi, StorageClass local-path, Delete=false; Unterordner meta/ und data/
Zugangsdaten Secret garage-secrets (Schlüssel rpcSecret, accessKey, secretKey) aus einem SealedSecret, Werte secrets.encrypted*
Bucket argo-artifacts (defaultBucket), Key hat Lesen, Schreiben, Owner
Region garage (s3Region), Argo Workflows signiert mit derselben Region
Ports 3900 S3-API (Service garage), 3903 Admin-API nur für die Probes (/health, ohne Token)
Ressourcen Request 20m und 64 MiB, Limit 1 CPU und 512 MiB
Pod läuft als UID 1000, Root-Dateisystem schreibgeschützt, keine Capabilities

Verwendung: Argo Workflows schreibt Artefakte und Logs in den Bucket argo-artifacts, siehe f0000. Zugriff aus anderen Namespaces sperrt die NetworkPolicy tier-default-ingress, freigegeben ist nur argo-workflows (d0030).


Zugangsdaten

Key und RPC-Secret liegen als SealedSecret im Repo (Token-Register-Eintrag garage-s3-keys, Versiegeln: Sealed Secrets). Den Klartext liest man bei Bedarf aus dem Cluster:

kubectl -n garage get secret garage-secrets -o jsonpath='{.data.accessKey}' | base64 -d; echo
kubectl -n garage get secret garage-secrets -o jsonpath='{.data.secretKey}' | base64 -d; echo

Rotation: scripts/seal-garage.sh in capulus-core erzeugt alle drei Werte neu und versiegelt den Key zusätzlich für argo-workflows/argo-artifacts-s3; PR, Merge, Garage startet neu und legt den neuen Key mit Bucket-Rechten an. Der alte Key bleibt in Garage bestehen und wird von Hand gelöscht:

kubectl -n garage exec deploy/garage -- /garage key list
kubectl -n garage exec deploy/garage -- /garage key delete --yes <ALTE_KEY_ID>

Fehlersuche

kubectl -n garage get pods,pvc
kubectl -n garage logs deploy/garage --tail=100
kubectl -n garage exec deploy/garage -- /garage status
kubectl -n garage exec deploy/garage -- /garage bucket info argo-artifacts
Symptom Ursache Lösung
Pod CrashLoopBackOff, Log Access key … is associated with a secret key different than the one given Secret-Key zur selben Key-ID geändert Key-ID ebenfalls neu erzeugen (seal-garage.sh macht beides) oder alten Key mit garage key delete entfernen
Log Access key … was deleted in the cluster, cannot add it back Key mit garage key delete gelöscht, aber noch in garage-secrets seal-garage.sh laufen lassen, neue Key-ID
Log Refusing to run in single-node mode Layout wurde von Hand geändert (Version > 1) --single-node ist nur für den Ein-Knoten-Betrieb; Layout zurücksetzen oder PVC leeren
Pod CreateContainerConfigError (secret "garage-secrets" not found) SealedSecret nicht entschlüsselt Sealed Secrets: Fehlersuche
Argo Workflows meldet AuthorizationHeaderMalformed oder InvalidRegion Region in artifactRepository.s3.region passt nicht zu s3Region beide auf garage
Argo Workflows meldet Forbidden beim Artefakt-Upload Key in argo-artifacts-s3 passt nicht zu garage-secrets seal-garage.sh versiegelt beide aus demselben Lauf
Pod Pending local-path bindet die PVC an den Node, auf dem sie angelegt wurde Node prüfen; Daten sind nur Logs und Artefakte, PVC löschen ist vertretbar
Speicher voll 10 GiB erreicht, Artefakte werden nicht aufgeräumt garage bucket info argo-artifacts, alte Objekte löschen oder persistence.size erhöhen

Allgemeine Fehlersuche: zentrale Fehlersuche.