Zum Inhalt springen
Trainingslager IT-Trainingslager

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 sourceRef zu ä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 $F

Erwartet:

---
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 zu 6.16.x passt. Andere Möglichkeiten sind branch, tag (genau ein Tag) und commit.
  • 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 git

Erwartet (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/version

Erwartet:

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

Erwartet (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/version

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

Erwartet:

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 podinfo

Erwartet:

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 registry

Erwartet (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/_catalog

Erwartet:

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

Erwartet (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/notes

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

Erwartet: ocirepository/podinfo mit 6.17.0@sha256:… und gitrepository/flux-system, beide READY True.

flux get kustomizations

Erwartet: flux-system, notes, podinfo und registry, alle READY True.

curl -s localhost:30500/v2/notes/tags/list

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

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

Erwartet (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 verify in der OCIRepository prüft die Signatur mit cosign (siehe „Sichere Lieferketten zum Anfassen“).
  • Zugangsdaten: Für private Registries bekommt die OCIRepository ein secretRef oder, in der Cloud, provider: aws|azure|gcp mit Workload Identity, ganz ohne gespeichertes Passwort.
  • Fremde Repos pinnen: semver: 6.17.x holt Patches automatisch. Wer jede Änderung sehen will, pinnt einen genauen tag oder sogar den digest und lässt Updates per Pull Request kommen, etwa mit Renovate.