Tag 5: Helm-Quellen
Ziel: Ein fremdes Helm-Chart läuft über Argo CD, erst mit Werten in der Application, dann mit Werten aus dem Fleet-Repo über Multiple Sources. · Dauer: ca. 45 min · Voraussetzung: Tag 3
Briefing
- Eine Quelle kann statt eines Git-Pfads ein
Helm-Chart aus einem Chart-Repo sein:
repoURList das Chart-Repo,chartder Name,targetRevisiondie Chart-Version. - Argo CD führt kein
helm installaus. Der repo-server rendert das Chart mithelm template, und Argo CD wendet das Ergebnis an wie jedes andere Manifest. Es gibt deshalb kein Helm-Release im Cluster. - Werte stehen entweder in der Application (
valuesObject) oder in einer Datei. Liegt die Datei in einem anderen Repo als das Chart, braucht es Multiple Sources: eine Quelle für das Chart, eine zweite mitref, auf die sich die erste mit$namebezieht. - Beispiel für heute ist podinfo, ein kleines Demo-Programm mit Weboberfläche und einem öffentlichen Chart.
Application podinfo
sources[0]: Chart podinfo 6.16.0 ── valueFiles: $fleet/values/podinfo.yaml
sources[1]: argocd-fleet (main) ── ref: fleet ──────────────┘
Drill 1: Das Chart ansehen
Helm auf der VM brauchst du nur, um das Chart vorher anzusehen:
helm repo add podinfo https://stefanprodan.github.io/podinfo
helm search repo podinfo --versions | head -4Erwartet:
"podinfo" has been added to your repositories
NAME CHART VERSION APP VERSION DESCRIPTION
podinfo/podinfo 6.17.0 6.17.0 Podinfo Helm chart for Kubernetes
podinfo/podinfo 6.16.0 6.16.0 Podinfo Helm chart for Kubernetes
podinfo/podinfo 6.15.0 6.15.0 Podinfo Helm chart for Kubernetes
Welche Werte das Chart kennt, zeigt helm show values. Du
legst sie in eine Datei und suchst die Stellen, die du gleich setzt:
mkdir -p ~/argo-lab/tag05
cd ~/argo-lab/tag05
helm show values podinfo/podinfo --version 6.16.0 > podinfo-werte.yaml
wc -l podinfo-werte.yaml
grep -n "replicaCount:" podinfo-werte.yaml
grep -n "message:" podinfo-werte.yaml
grep -n "nodePort:" podinfo-werte.yamlErwartet:
322 podinfo-werte.yaml
3:replicaCount: 1
19: message: ""
42: nodePort: 31198
Du nimmst bewusst 6.16.0 und nicht die neueste Version. Das Update kommt in der Challenge.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Chart mit Werten in der Application
cat > podinfo-app.yaml <<'EOF'
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: podinfo
namespace: argocd
spec:
project: default
source:
repoURL: https://stefanprodan.github.io/podinfo
chart: podinfo
targetRevision: 6.16.0
helm:
valuesObject:
ui:
message: Hallo aus Argo CD
service:
type: NodePort
nodePort: 30090
destination:
server: https://kubernetes.default.svc
namespace: podinfo
syncPolicy:
automated:
prune: true
selfHeal: true
syncOptions:
- CreateNamespace=true
EOF
kubectl apply -f podinfo-app.yaml
argocd app wait podinfo --healthErwartet (gekürzt):
application.argoproj.io/podinfo created
…
Sync Status: Synced to 6.16.0
…
GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
Namespace podinfo Running Synced namespace/podinfo created
Service podinfo podinfo Synced Healthy service/podinfo created
apps Deployment podinfo podinfo Synced Healthy deployment.apps/podinfo created
Ein öffentliches Chart-Repo muss nicht angemeldet werden.
Synced to 6.16.0 nennt die Chart-Version statt eines
Commits.
curl -s localhost:30090 | grep -E '"version|"message'Erwartet:
"version": "6.16.0",
"message": "Hallo aus Argo CD",
Im Browser zeigt http://172.16.0.182:30090 die
Weboberfläche von podinfo mit deiner Nachricht.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Kein Helm-Release
helm list -AErwartet:
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
gateway-api-crd kube-system 1 2026-11-14 08:10:31.54139108 +0000 UTC deployed gateway-api-crd-1.6.301 v1.6.3
podinfo fehlt. Das einzige Release hat k3s selbst bei der Installation angelegt. Für Helm existiert podinfo nicht, für Argo CD ist es eine gewöhnliche Application mit zwei Objekten:
argocd app manifests podinfo | grep "^kind:"Erwartet:
kind: Service
kind: Deployment
Daraus folgt: helm upgrade und
helm rollback haben hier nichts zu suchen. Helm-Hooks im
Chart übersetzt Argo CD in eigene Hooks, etwa pre-install
in PreSync.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Werte aus Git
Werte in der Application sind bequem, aber die Application liegt noch nicht in Git. Besser kommen die Werte als Datei ins Fleet-Repo:
cd ~/argo-lab/argocd-fleet
mkdir -p values
cat > values/podinfo.yaml <<'EOF'
replicaCount: 2
ui:
message: Werte aus Git
color: "#2e7d32"
service:
type: NodePort
nodePort: 30090
EOF
git add .
git commit -m "podinfo-Werte"
git pushDas Chart liegt im Chart-Repo, die Werte im Fleet-Repo. Die
Application bekommt deshalb zwei Quellen. Statt source
heißt das Feld jetzt sources:
cd ~/argo-lab/tag05
cat > podinfo-app.yaml <<'EOF'
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: podinfo
namespace: argocd
spec:
project: default
sources:
- repoURL: https://stefanprodan.github.io/podinfo
chart: podinfo
targetRevision: 6.16.0
helm:
valueFiles:
- $fleet/values/podinfo.yaml
- repoURL: [email protected]:<du>/argocd-fleet.git
targetRevision: main
ref: fleet
destination:
server: https://kubernetes.default.svc
namespace: podinfo
syncPolicy:
automated:
prune: true
selfHeal: true
syncOptions:
- CreateNamespace=true
EOF
kubectl apply -f podinfo-app.yaml
argocd app wait podinfo --health --sync
argocd app get podinfo | sed -n "/^Sources/,/^SyncWindow/p"Erwartet (gekürzt):
application.argoproj.io/podinfo configured
…
Sources:
- Repo: https://stefanprodan.github.io/podinfo
Target: 6.16.0
Helm Values: $fleet/values/podinfo.yaml
- Repo: [email protected]:<du>/argocd-fleet.git
Target: main
Ref: fleet
SyncWindow: Sync Allowed
ref: fleetgibt der zweiten Quelle einen Namen. Sie liefert selbst keine Manifeste.$fleet/values/podinfo.yamlist der Pfad innerhalb dieser Quelle.
kubectl -n podinfo get deploy podinfo
curl -s localhost:30090 | grep -E '"message|"color'Erwartet:
NAME READY UP-TO-DATE AVAILABLE AGE
podinfo 2/2 2 2 45s
"color": "#2e7d32",
"message": "Werte aus Git",
Ab jetzt ändert ein Commit an values/podinfo.yaml den
Cluster.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Parameter auf der Befehlszeile
Die CLI kann einzelne Werte direkt in der Application setzen:
argocd app set podinfo -p replicaCount=3Erwartet:
{"level":"fatal","msg":"Source position should be specified and must be greater than 0 for applications with multiple sources","time":"…"}
Bei mehreren Quellen musst du sagen, welche gemeint ist. Gezählt wird
ab 1:
argocd app set podinfo --source-position 1 -p replicaCount=3
sleep 15
kubectl -n podinfo get deploy podinfo
kubectl -n argocd get app podinfo -o jsonpath='{.spec.sources[0].helm}'Erwartet:
NAME READY UP-TO-DATE AVAILABLE AGE
podinfo 2/3 3 2 78s
{"parameters":[{"name":"replicaCount","value":"3"}],"valueFiles":["$fleet/values/podinfo.yaml"]}
Der Wert steht jetzt in der Application im Cluster, nicht in Git und
nicht in deiner Datei podinfo-app.yaml. Das nächste
kubectl apply der Datei würde ihn still entfernen. Für
Versuche ist -p praktisch, für den Betrieb ist es eine
Falle. Du nimmst ihn wieder heraus:
argocd app unset podinfo --source-position 1 -p replicaCount
sleep 15
kubectl -n podinfo get deploy podinfoErwartet:
NAME READY UP-TO-DATE AVAILABLE AGE
podinfo 2/2 2 2 94s
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
argocd app get podinfo | grep -E "Sync Status|Health Status"Erwartet: Synced to 6.16.0 und Healthy.
curl -s localhost:30090 | grep '"message'Erwartet: "message": "Werte aus Git",.
argocd app history podinfoErwartet: zwei Blöcke, einer pro Quelle. Der Block des Fleet-Repos
nennt main mit einem Commit.
Challenge
Hebe podinfo auf Chart-Version 6.17.0.
Hinweis: Die Chart-Version steht in der Application, nicht in den Werten.
Lösung
cd ~/argo-lab/tag05
sed -i "s/targetRevision: 6.16.0/targetRevision: 6.17.0/" podinfo-app.yaml
kubectl apply -f podinfo-app.yaml
argocd app wait podinfo --health --sync
curl -s localhost:30090 | grep '"version'Erwartet (gekürzt):
application.argoproj.io/podinfo configured
…
"version": "6.17.0",
Weil die Application noch eine Datei auf deiner VM ist, steht das Update in keinem Commit. Ab Tag 7 liegen auch die Applications im Fleet-Repo.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Chart-Versionen immer fest angeben, nie
*oder einen Bereich. Sonst ändert ein neues Chart den Cluster ohne Commit. - Charts aus OCI-Registries gehen genauso. Das Repo wird dann mit
--enable-ociangemeldet. - Eine Firma spiegelt fremde Charts meist in eine eigene Registry, damit ein gelöschtes Chart-Repo keine Deployments verhindert.