Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 9: Image Automation I – Images beobachten

Ziel: Die beiden Image-Controller nachinstallieren, den Deploy-Key schreibfähig machen und Flux beibringen, in ghcr nach neuen Versionen von notes-api zu suchen. · Dauer: ca. 60 min · Voraussetzung: Tag 8

Briefing

Bisher änderst du die Version von notes-api von Hand in Git. Image Automation übernimmt das in zwei Stufen, verteilt auf zwei Controller:

Controller Objekt Aufgabe Tag
image-reflector-controller ImageRepository Tags einer Registry regelmäßig lesen 9
image-reflector-controller ImagePolicy aus den Tags den passenden auswählen 9
image-automation-controller ImageUpdateAutomation den gewählten Tag in Git schreiben und pushen 10
  • Beide Controller sind nicht Teil der Standard-Installation. Du installierst sie mit flux bootstrap nach, mit demselben Befehl wie an Tag 1 und einer Option mehr.
  • Die Automation schreibt in Git. Flux braucht dafür einen Deploy-Key, der schreiben darf. Seit Tag 1 darf er nur lesen.
  • Wichtig: Flux ändert nie direkt das Image im Cluster. Es schreibt einen Commit, und der läuft den normalen Weg. Git bleibt die einzige Wahrheit.

Drill 1: Controller nachinstallieren

Bevor du weitermachst, holst du den Stand von GitHub. Der Bootstrap committet gleich ins Repo, und dein lokaler Klon soll nicht zurückliegen:

cd ~/flux-lab/fleet
git pull
flux bootstrap github --owner=$GITHUB_USER --repository=flux-fleet \
  --branch=main --path=clusters/lab --personal --private=true \
  --components-extra=image-reflector-controller,image-automation-controller \
  --read-write-key

Erwartet (gekürzt):

✔ committed component manifests to "main" ("1b0b397f3b2a2d2cf131314e8438805b077d03ee")
► pushing component manifests to "https://github.com/<du>/flux-fleet.git"
✔ reconciled components
► determining if source secret "flux-system/flux-system" exists
✔ source secret up to date
...
✔ image-automation-controller: deployment ready
✔ image-reflector-controller: deployment ready
...
✔ all components are healthy

Zwei neue Controller, aber eine Zeile verdient einen zweiten Blick: source secret up to date. Der Bootstrap hat den bestehenden Deploy-Key behalten, --read-write-key gilt nur für neue Schlüssel. Auf GitHub (flux-fleet → Settings → Deploy keys) steht weiter „Read-only“.

Du löschst das Secret mit dem Schlüssel, und der nächste Bootstrap erzeugt einen neuen:

kubectl -n flux-system delete secret flux-system
flux bootstrap github --owner=$GITHUB_USER --repository=flux-fleet \
  --branch=main --path=clusters/lab --personal --private=true \
  --components-extra=image-reflector-controller,image-automation-controller \
  --read-write-key

Erwartet (gekürzt):

secret "flux-system" deleted from flux-system namespace
...
► determining if source secret "flux-system/flux-system" exists
► generating source secret
✔ public key: ecdsa-sha2-nistp384 AAAAE2VjZHNhLXNoYTItbmlzdHAzODQAAAAIbmlz...
✔ configured deploy key "flux-system-main-flux-system-./clusters/lab" for "https://github.com/<du>/flux-fleet"
...
✔ all components are healthy

Der Bootstrap hat den alten Deploy-Key auf GitHub durch den neuen ersetzt. Ohne „Read-only“ steht er jetzt dort.

git pull
kubectl -n flux-system get deploy

Erwartet (das Alter weicht ab):

NAME                          READY   UP-TO-DATE   AVAILABLE   AGE
helm-controller               1/1     1            1           7h
image-automation-controller   1/1     1            1           3m
image-reflector-controller    1/1     1            1           3m
kustomize-controller          1/1     1            1           7h
notification-controller       1/1     1            1           75m
source-controller             1/1     1            1           7h

Fortschritt speichern? Kostenlos registrieren

Drill 2: Ein Repository beobachten

Die Objekte für die Image Automation gehören in den Cluster-Ordner, denn sie betreffen alle Umgebungen:

F=clusters/lab/notes-images.yaml
flux create image repository notes-api --image=ghcr.io/thomaszachmann/notes-api \
  --interval=10m --export > $F
flux create image policy notes-api --image-ref=notes-api \
  --select-semver=">=0.5.0" --export >> $F
cat $F

Erwartet:

---
apiVersion: image.toolkit.fluxcd.io/v1
kind: ImageRepository
metadata:
  name: notes-api
  namespace: flux-system
spec:
  image: ghcr.io/thomaszachmann/notes-api
  interval: 10m0s
---
apiVersion: image.toolkit.fluxcd.io/v1
kind: ImagePolicy
metadata:
  name: notes-api
  namespace: flux-system
spec:
  imageRepositoryRef:
    name: notes-api
  policy:
    semver:
      range: '>=0.5.0'
git add -A
git commit -m "notes-api: Images beobachten"
git push
flux reconcile kustomization flux-system --with-source
flux get image repository
flux get image policy

Erwartet (gekürzt):

NAME        LAST SCAN               SUSPENDED   READY   MESSAGE
notes-api   2026-11-12T16:51:49Z    False       True    successful scan: found 130 tags with checksum sha256:8e4aea79…
NAME        IMAGE                               TAG     READY   MESSAGE
notes-api   ghcr.io/thomaszachmann/notes-api    0.7.1   True    Latest image tag for ghcr.io/thomaszachmann/notes-api resolved to 0.7.1

Die Policy hat unter allen Tags die höchste Version gefunden, die zu >=0.5.0 passt. Vorabversionen wie 0.6.0-rc.4 zählen bei SemVer nicht, solange der Bereich selbst keine enthält.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Was ist das für ein Müll?

130 Tags für eine Handvoll Versionen? Ein Blick auf die zuletzt gelesenen:

kubectl -n flux-system get imagerepository notes-api \
  -o jsonpath='{.status.lastScanResult.latestTags}{"\n"}' | tr , '\n' | head -3

Erwartet:

["sha256-fadb2fe90ea04229a9586865474eea5f0b91806cbca535affe6fb48c31f07c4e"
"sha256-f72f0f1c3a640086eaacd443e4dbaeda0bf21be31acb00ba8ed59d9cc9eccc15"
"sha256-f214133d6effdf6d330a7f0adf06b3ca03350b9a291ea3c10d948e3bce5ed7c1"
  • sha256-… sind keine Images, sondern Attestierungen wie SBOMs und Herkunftsnachweise. Die CI hängt sie an jedes gebaute Image (siehe „Sichere Lieferketten zum Anfassen“).
  • Dazu kommen Tags wie sha-fda8903: ein Image pro Commit.

Der Policy schaden sie nicht, denn SemVer ignoriert alles, was keine Version ist. Aber der Controller speichert jeden Tag, bei jedem Scan. Eine exclusionList filtert schon beim Lesen. Ergänze in clusters/lab/notes-images.yaml unter image::

  image: ghcr.io/thomaszachmann/notes-api
  exclusionList:
    - ^.*\.sig$
    - ^sha

Die erste Zeile ist der Standardwert (cosign-Signaturen). Wer die Liste setzt, überschreibt ihn, also gehört er mit hinein.

git commit -am "notes-api: nur Versions-Tags"
git push
flux reconcile kustomization flux-system --with-source
flux reconcile image repository notes-api
kubectl -n flux-system get imagerepository notes-api \
  -o jsonpath='{.status.lastScanResult.latestTags}{"\n"}'

Erwartet (gekürzt):

✔ scan fetched 13 tags
["main","latest","0.7.1","0.7.0","0.7","0.6.0-rc.4","0.6.0-rc.3","0.6.0-rc.2","0.6.0-rc.1","0.5.3"]

13 statt 130. main und latest sind bewegliche Tags. Die Policy übergeht sie, und in Git sollten sie nie stehen.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Andere Auswahlregeln

SemVer ist die häufigste Regel, aber nicht die einzige. Zum Ausprobieren legst du zwei Policies direkt im Cluster an, ohne --export. Sie fliegen danach wieder raus.

Nur Patches von 0.5, per regulärem Ausdruck und Zahlenvergleich:

flux create image policy nur-05 --image-ref=notes-api \
  --filter-regex='^0\.5\.(?P<p>[0-9]+)$' --filter-extract='$p' --select-numeric=asc
  • --filter-regex lässt nur Tags durch, die passen. (?P<p>…) merkt sich die Patch-Nummer.
  • --filter-extract='$p' vergleicht nur diesen Teil, --select-numeric=asc nimmt den höchsten.

Dieselbe Technik passt für Tags wie main-20261112-1530, die keine SemVer-Versionen sind: Zeitstempel extrahieren, numerisch sortieren.

flux get image policy

Erwartet:

NAME        IMAGE                               TAG     READY   MESSAGE
notes-api   ghcr.io/thomaszachmann/notes-api    0.7.1   True    Latest image tag for ghcr.io/thomaszachmann/notes-api resolved to 0.7.1
nur-05      ghcr.io/thomaszachmann/notes-api    0.5.3   True    Latest image tag for ghcr.io/thomaszachmann/notes-api resolved to 0.5.3
flux delete image policy nur-05 --silent

Erwartet:

► deleting image policy nur-05 in flux-system namespace
✔ image policy deleted

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

flux get image repository

Erwartet: notes-api, READY True, found 13 tags.

flux get image policy

Erwartet: genau eine Policy notes-api mit 0.7.1.

diff ~/flux-lab/fleet/clusters/lab/notes-images.yaml \
  ~/flux-lab/code/loesung/tag09/clusters/lab/notes-images.yaml

Erwartet: keine Ausgabe.

Challenge

Das QA-Team will die Release-Kandidaten der Reihe 0.6 testen, sobald sie erscheinen, aber nie eine fertige 0.7. Schreib eine Policy notes-api-rc dafür, diesmal in Git. Welchen Tag wählt sie?

Hinweis: Ein SemVer-Bereich nimmt Vorabversionen nur auf, wenn er selbst eine enthält. -0 ist die kleinste mögliche.

Lösung

flux create image policy notes-api-rc --image-ref=notes-api \
  --select-semver=">=0.6.0-0 <0.7.0" --export >> clusters/lab/notes-images.yaml
git commit -am "notes-api: Policy für Release-Kandidaten"
git push
flux reconcile kustomization flux-system --with-source
flux get image policy

Erwartet (gekürzt):

NAME            IMAGE                               TAG         READY   MESSAGE
notes-api       ghcr.io/thomaszachmann/notes-api    0.7.1       True    Latest image tag for ghcr.io/thomaszachmann/notes-api resolved to 0.7.1
notes-api-rc    ghcr.io/thomaszachmann/notes-api    0.6.0-rc.4  True    Latest image tag for ghcr.io/thomaszachmann/notes-api resolved to 0.6.0-rc.4
  • >=0.6.0-0 öffnet den Bereich für Vorabversionen von 0.6.0 an.
  • <0.7.0 schließt 0.7.0 und alles darüber aus.
  • Erscheint ein 0.6.0-rc.5, wählt die Policy ihn beim nächsten Scan. Gäbe es eine fertige 0.6.0, wäre die höher als jeder RC und würde gewählt.

Der Kontrollpunkt von oben zeigt jetzt zwei Policies. Den Vergleich mit dem Begleitcode machst du gegen tag10, dort ist die Policy schon enthalten.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Private Registries: Die ImageRepository bekommt ein secretRef mit Docker-Zugangsdaten oder in der Cloud provider: aws|azure|gcp. Dann holt sich der Controller per Workload Identity ein kurzlebiges Token.
  • Scan-Intervall und Rate Limits: Viele ImageRepositories mit kurzem Intervall stoßen bei Docker Hub schnell an Grenzen. Zehn Minuten oder mehr sind üblich. Für sofortige Updates schickt die Registry einen Webhook an einen Flux-Receiver (Tag 11).
  • Digest pinnen: spec.digestReflectionPolicy: Always an der ImagePolicy liefert neben dem Tag auch den Digest. Damit kann die Automation notes-api:0.7.1@sha256:… schreiben, und ein überschriebener Tag schleicht sich nicht unbemerkt ein.