Tag 3: Sources
Ziel: Manifeste aus einem fremden Git-Repo, über SemVer-Tags und als OCI-Artefakt holen, eine eigene Registry betreiben und eigene Artefakte hineinschieben. · Dauer: ca. 75 min · Voraussetzung: Tag 2
Briefing
- Eine Source sagt Flux, woher Manifeste
kommen. Eine Kustomization sagt, was davon wie
angewendet wird. Beide sind getrennte Objekte. Deshalb kannst du die
Quelle austauschen, ohne an der Kustomization mehr als
sourceRefzu ändern. - Der source-controller kennt diese Arten:
| Source | Holt aus | Typischer Einsatz |
|---|---|---|
GitRepository |
Git (Branch, Tag, SemVer, Commit) | das Fleet-Repo, Repos anderer Teams |
OCIRepository |
OCI-Registry (ghcr, Harbor, ECR …) | Artefakte aus der CI, Helm-Charts |
HelmRepository |
klassisches Helm-Repo (index.yaml) |
fremde Charts (Tag 6) |
Bucket |
S3-kompatibler Speicher | Umgebungen ohne Git-Zugriff |
- Heute kommt eine fremde App dazu: podinfo, eine kleine Web-App, die das Flux-Projekt selbst für Beispiele pflegt. Sie hat Git-Tags mit Versionen und veröffentlicht ihre Manifeste zusätzlich als OCI-Artefakt.
github.com/stefanprodan/podinfo ── GitRepository (Drill 1–3)
ghcr.io/stefanprodan/manifests/podinfo ── OCIRepository (Drill 4)
Registry im Cluster :30500 ◄── flux push artifact ── apps/notes (Drill 5)
Drill 1: Ein fremdes Repo
Namespace, Quelle und Kustomization für podinfo kommen in eine
einzige Datei in clusters/lab. Den Namespace schreibst du
selbst, den Rest erzeugt flux create:
cd ~/flux-lab/fleet
F=clusters/lab/podinfo.yaml
printf -- '---\napiVersion: v1\nkind: Namespace\nmetadata:\n name: podinfo\n' > $F
flux create source git podinfo --url=https://github.com/stefanprodan/podinfo \
--tag-semver="6.16.x" --interval=10m --export >> $F
flux create kustomization podinfo --source=GitRepository/podinfo \
--path=./kustomize --prune=true --interval=10m --target-namespace=podinfo \
--export >> $F
cat $FErwartet:
---
apiVersion: v1
kind: Namespace
metadata:
name: podinfo
---
apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata:
name: podinfo
namespace: flux-system
spec:
interval: 10m0s
ref:
semver: 6.16.x
url: https://github.com/stefanprodan/podinfo
---
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
name: podinfo
namespace: flux-system
spec:
interval: 10m0s
path: ./kustomize
prune: true
sourceRef:
kind: GitRepository
name: podinfo
targetNamespace: podinfo
ref.semver: 6.16.x: Flux sucht unter allen Tags des Repos den höchsten, der zu6.16.xpasst. Andere Möglichkeiten sindbranch,tag(genau ein Tag) undcommit.targetNamespace: Die Manifeste von podinfo haben keinen Namespace. Flux setzt ihn beim Anwenden. Anlegen tut Flux den Namespace dabei nicht, deshalb steht er selbst in der Datei.- Das Repo ist öffentlich, also braucht die Quelle kein
secretRef.
git add -A
git commit -m "podinfo aus fremdem Repo"
git push
flux reconcile kustomization flux-system --with-source
flux get sources gitErwartet (gekürzt):
NAME REVISION SUSPENDED READY MESSAGE
flux-system main@sha1:2be5fe37 False True stored artifact for revision 'main@sha1:2be5fe37'
podinfo 6.16.0@sha1:256d0346 False True stored artifact for revision '6.16.0@sha1:256d0346'
Die Revision nennt jetzt den Tag (6.16.0) und den Commit
dahinter.
podinfo hat nur einen Service vom Typ ClusterIP, also
ohne NodePort. Den API-Server kannst du trotzdem bitten, die Anfrage
weiterzureichen:
kubectl -n podinfo rollout status deploy/podinfo
kubectl get --raw /api/v1/namespaces/podinfo/services/podinfo:9898/proxy/versionErwartet:
deployment "podinfo" successfully rolled out
{
"commit": "256d03466ae4277ca1746c212f92c9a1d384d307",
"version": "6.16.0"
}
Fortschritt speichern? Kostenlos registrieren
Drill 2: Eine neue Version
Ein Minor-Update ist eine Zeile:
sed -i 's/semver: 6.16.x/semver: 6.17.x/' clusters/lab/podinfo.yaml
git commit -am "podinfo 6.17"
git push
flux reconcile kustomization flux-system --with-source
flux reconcile kustomization podinfo --with-sourceErwartet (gekürzt):
✔ applied revision main@sha1:9ab57e39eba62e6f94a7c14dcf97a37907659d5c
...
✔ fetched revision 6.17.0@sha1:fd3a834ed8d14b80ea334cf8a2fddd4597924da6
...
✔ applied revision 6.17.0@sha1:fd3a834ed8d14b80ea334cf8a2fddd4597924da6
kubectl -n podinfo rollout status deploy/podinfo
kubectl get --raw /api/v1/namespaces/podinfo/services/podinfo:9898/proxy/versionErwartet (gekürzt):
"version": "6.17.0"
Ein Patch-Release wie 6.17.1 käme ohne Commit: Die
Quelle sieht alle zehn Minuten nach neuen Tags und nimmt den höchsten,
der zu 6.17.x passt.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Nur holen, was du brauchst
Die Quelle lädt das ganze Repo von podinfo, mit Quellcode, Charts und
Doku. Angewendet wird nur kustomize/. Wie groß ist das
Artefakt?
kubectl -n flux-system get gitrepository podinfo \
-o jsonpath='{.status.artifact.size}{"\n"}'Erwartet (ungefähr):
429596
Rund 430 KB, für vier YAML-Dateien. spec.ignore arbeitet
wie eine .gitignore: Erst alles ausschließen, dann den
Ordner wieder hereinnehmen. Öffne clusters/lab/podinfo.yaml
im Editor und ergänze unter url in der GitRepository:
url: https://github.com/stefanprodan/podinfo
ignore: |
/*
!/kustomize/
git commit -am "podinfo: nur kustomize/ holen"
git push
flux reconcile kustomization flux-system --with-source
flux reconcile source git podinfo
kubectl -n flux-system get gitrepository podinfo \
-o jsonpath='{.status.artifact.size}{"\n"}'Erwartet (gekürzt):
✔ fetched revision 6.17.0@sha1:fd3a834ed8d14b80ea334cf8a2fddd4597924da6
1150
Vom Repo bleiben gut 1 KB. Bei großen Monorepos spart das Speicher im source-controller und Zeit bei jedem Abgleich.
Fortschritt speichern? Kostenlos registrieren
Drill 4: OCI statt Git
podinfo veröffentlicht dieselben Manifeste bei jedem Release als OCI-Artefakt in ghcr. Ein OCI-Artefakt ist ein Paket in einer Container-Registry, aber kein Image, sondern ein Archiv mit Dateien. Für Flux ist das die bessere Quelle: Es holt nur die Manifeste, unveränderlich über einen Digest adressiert, ohne Git-Historie.
Ersetze in clusters/lab/podinfo.yaml die ganze
GitRepository durch:
---
apiVersion: source.toolkit.fluxcd.io/v1
kind: OCIRepository
metadata:
name: podinfo
namespace: flux-system
spec:
interval: 10m0s
ref:
semver: 6.17.x
url: oci://ghcr.io/stefanprodan/manifests/podinfo
In der Kustomization ändern sich zwei Zeilen. Das Artefakt enthält nur die Manifeste, also gibt es keinen Unterordner mehr:
path: ./
...
sourceRef:
kind: OCIRepository
name: podinfo
git commit -am "podinfo als OCI-Artefakt"
git push
flux reconcile kustomization flux-system --with-source
flux get sources allErwartet:
NAME REVISION SUSPENDED READY MESSAGE
ocirepository/podinfo 6.17.0@sha256:3a5e82b1 False True stored artifact for digest '6.17.0@sha256:3a5e82b1'
NAME REVISION SUSPENDED READY MESSAGE
gitrepository/flux-system main@sha1:b76b5b00 False True stored artifact for revision 'main@sha1:b76b5b00'
Die GitRepository podinfo ist verschwunden. Sie stand in
Git, du hast sie gelöscht, und prune in
flux-system hat sie entfernt. Am laufenden podinfo ändert
sich nichts:
flux get kustomization podinfoErwartet:
NAME REVISION SUSPENDED READY MESSAGE
podinfo 6.17.0@sha256:3a5e82b1 False True Applied revision: 6.17.0@sha256:3a5e82b1
Fortschritt speichern? Kostenlos registrieren
Drill 5: Eine eigene Registry
Wer eigene Artefakte bauen will, braucht eine Registry. Im Lab läuft
sie im Cluster, natürlich aus Git. Sie bekommt einen eigenen Bereich
infrastructure/:
mkdir -p infrastructure/registry
cd infrastructure/registry
printf 'apiVersion: v1\nkind: Namespace\nmetadata:\n name: registry\n' > namespace.yaml
cat > deployment.yaml <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata:
name: registry
namespace: registry
spec:
replicas: 1
selector:
matchLabels:
app: registry
template:
metadata:
labels:
app: registry
spec:
containers:
- name: registry
image: registry:3.0.0
ports:
- containerPort: 5000
readinessProbe:
httpGet:
path: /v2/
port: 5000
EOF
cat > service.yaml <<'EOF'
apiVersion: v1
kind: Service
metadata:
name: registry
namespace: registry
spec:
type: NodePort
selector:
app: registry
ports:
- port: 5000
targetPort: 5000
nodePort: 30500
EOF
cat > kustomization.yaml <<'EOF'
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- namespace.yaml
- deployment.yaml
- service.yaml
EOF
cd ~/flux-lab/fleet
flux create kustomization registry --source=GitRepository/flux-system \
--path=./infrastructure/registry --prune=true --interval=10m --wait=true \
--export > clusters/lab/registry.yaml
git add -A
git commit -m "Registry im Cluster"
git push
flux reconcile kustomization flux-system --with-source
flux reconcile kustomization registryErwartet (gekürzt):
✔ applied revision main@sha1:610b75c8e163da9208cac09f64960c6496946179
...
✔ applied revision main@sha1:610b75c8e163da9208cac09f64960c6496946179
--wait=true lässt die Kustomization erst
Ready melden, wenn die Registry wirklich läuft. Mehr dazu
morgen.
curl -s localhost:30500/v2/_catalogErwartet:
{"repositories":[]}
Die Registry ist leer, ohne Anmeldung und ohne TLS. Im Lab ist das in Ordnung, nach draußen gehört so etwas nie.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Ein eigenes Artefakt
Die Manifeste von notes-api verpackst du jetzt als OCI-Artefakt. Als Tag nimmst du den kurzen Commit-Hash, und Quelle und Revision schreibst du als Herkunftsnachweis mit hinein:
flux push artifact oci://localhost:30500/notes:$(git rev-parse --short HEAD) \
--path=./apps/notes \
--source="$(git config --get remote.origin.url)" \
--revision="main@sha1:$(git rev-parse HEAD)" \
--insecure-registryErwartet (der Digest weicht ab):
► pushing artifact to localhost:30500/notes:610b75c
✔ artifact successfully pushed to localhost:30500/notes@sha256:cd594d31346d754f9011c56a305ebf3420d1ccbd704e8c67421314bef9cfc4a2
--insecure-registry erlaubt HTTP statt HTTPS. Einen Tag
wie stable hängst du nachträglich an. Das ist der Moment,
in dem ein Artefakt „freigegeben“ wird:
flux tag artifact oci://localhost:30500/notes:$(git rev-parse --short HEAD) --tag=stable
flux list artifacts oci://localhost:30500/notesErwartet (gekürzt):
► tagging artifact
✔ artifact tagged as localhost:30500/notes:stable
ARTIFACT DIGEST SOURCE REVISION
localhost:30500/notes:stable sha256:cd594d31… https://github.com/<du>/flux-fleet.git main@sha1:610b75c8…
localhost:30500/notes:610b75c sha256:cd594d31… https://github.com/<du>/flux-fleet.git main@sha1:610b75c8…
Beide Tags zeigen auf denselben Digest, also auf dasselbe Paket.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
flux get sources allErwartet: ocirepository/podinfo mit
6.17.0@sha256:… und gitrepository/flux-system,
beide READY True.
flux get kustomizationsErwartet: flux-system, notes,
podinfo und registry, alle READY
True.
curl -s localhost:30500/v2/notes/tags/listErwartet (dein Hash weicht ab):
{"name":"notes","tags":["610b75c","stable"]}
Challenge
Stell die Kustomization notes auf dein OCI-Artefakt mit
dem Tag stable um. Prüfe, dass
flux get kustomization notes die OCI-Revision zeigt, und
stell danach wieder auf Git zurück.
Hinweis: Im Cluster heißt die Registry nicht
localhost, sondern so, wie jeder Service:
<service>.<namespace>.svc.cluster.local. Und
auch der source-controller muss wissen, dass dort kein HTTPS läuft.
Lösung
flux create source oci notes \
--url=oci://registry.registry.svc.cluster.local:5000/notes \
--tag=stable --insecure --interval=1m --export > clusters/lab/notes-oci.yaml
sed -i -e 's/kind: GitRepository/kind: OCIRepository/' \
-e 's/name: flux-system/name: notes/' \
-e 's#path: ./apps/notes#path: ./#' clusters/lab/notes.yaml
git add -A
git commit -m "notes aus OCI"
git push
flux reconcile kustomization flux-system --with-source
flux get kustomization notesErwartet (gekürzt):
NAME REVISION SUSPENDED READY MESSAGE
notes stable@sha256:cd594d31 False True Applied revision: stable@sha256:cd594d31
notes-api läuft dabei ohne Unterbrechung weiter, denn im Artefakt stehen dieselben Manifeste. Zurück auf Git:
git revert --no-edit HEAD
git push
flux reconcile kustomization flux-system --with-source
flux get kustomization notesErwartet (gekürzt):
NAME REVISION SUSPENDED READY MESSAGE
notes main@sha1:546006db False True Applied revision: main@sha1:546006db
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Git → CI → OCI → Flux: Viele Teams lassen Flux
nicht mehr direkt aus Git lesen. Die CI prüft die Manifeste, schiebt sie
als signiertes OCI-Artefakt in die Registry, und Flux holt nur noch
freigegebene Tags. Der Cluster braucht dann keinen Zugang zu Git mehr,
und
verifyin der OCIRepository prüft die Signatur mit cosign (siehe „Sichere Lieferketten zum Anfassen“). - Zugangsdaten: Für private Registries bekommt die
OCIRepository ein
secretRefoder, in der Cloud,provider: aws|azure|gcpmit Workload Identity, ganz ohne gespeichertes Passwort. - Fremde Repos pinnen:
semver: 6.17.xholt Patches automatisch. Wer jede Änderung sehen will, pinnt einen genauentagoder sogar dendigestund lässt Updates per Pull Request kommen, etwa mit Renovate.