Zum Inhalt springen
Trainingslager IT-Trainingslager

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: repoURL ist das Chart-Repo, chart der Name, targetRevision die Chart-Version.
  • Argo CD führt kein helm install aus. Der repo-server rendert das Chart mit helm 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 mit ref, auf die sich die erste mit $name bezieht.
  • 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 -4

Erwartet:

"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.yaml

Erwartet:

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

Erwartet (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 -A

Erwartet:

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 push

Das 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: fleet gibt der zweiten Quelle einen Namen. Sie liefert selbst keine Manifeste.
  • $fleet/values/podinfo.yaml ist 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=3

Erwartet:

{"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 podinfo

Erwartet:

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 podinfo

Erwartet: 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-oci angemeldet.
  • Eine Firma spiegelt fremde Charts meist in eine eigene Registry, damit ein gelöschtes Chart-Repo keine Deployments verhindert.