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 bootstrapnach, 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-keyErwartet (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-keyErwartet (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 deployErwartet (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 $FErwartet:
---
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 policyErwartet (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 -3Erwartet:
["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-regexlässt nur Tags durch, die passen.(?P<p>…)merkt sich die Patch-Nummer.--filter-extract='$p'vergleicht nur diesen Teil,--select-numeric=ascnimmt 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 policyErwartet:
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 --silentErwartet:
► deleting image policy nur-05 in flux-system namespace
✔ image policy deleted
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
flux get image repositoryErwartet: notes-api, READY
True, found 13 tags.
flux get image policyErwartet: 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.yamlErwartet: 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 policyErwartet (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.0schließ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 fertige0.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
secretRefmit Docker-Zugangsdaten oder in der Cloudprovider: 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: Alwaysan der ImagePolicy liefert neben dem Tag auch den Digest. Damit kann die Automationnotes-api:0.7.1@sha256:…schreiben, und ein überschriebener Tag schleicht sich nicht unbemerkt ein.