Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 2: Die erste App aus Git

Ziel: notes-api aus dem Fleet-Repo ausrollen und erleben, wie Flux Abweichungen zurückdreht, Änderungen übernimmt und Gelöschtes aufräumt. · Dauer: ca. 60 min · Voraussetzung: Tag 1

Briefing

  • Der Weg einer Änderung heißt ab heute immer: Datei ändern, committen, pushen. kubectl apply brauchst du für notes-api nicht mehr.
  • Dafür bekommt notes-api eine eigene Kustomization. Sie zeigt auf den Ordner apps/notes im Fleet-Repo. Das Objekt selbst liegt in clusters/lab, und das wendet flux-system ohnehin an.
  • Reconcile ist der Abgleich zwischen Git und Cluster. Er läuft, sobald ein neuer Commit da ist, und zusätzlich in jedem Intervall. Beim Intervall-Lauf fällt auf, was jemand im Cluster von Hand geändert hat.
 flux-fleet/
 ├── apps/
 │   └── notes/            ← was laufen soll (Manifeste)
 └── clusters/lab/
     ├── flux-system/      ← Flux selbst
     └── notes.yaml        ← Kustomization „notes“: wende apps/notes an

Drill 1: Manifeste ins Repo

Die Dateien aus Tag 0 ziehen ins Fleet-Repo um:

cd ~/flux-lab/fleet
mkdir -p apps
mv ~/flux-lab/notes apps/notes
ls apps/notes

Erwartet:

deployment.yaml  kustomization.yaml  namespace.yaml  secret.yaml  service.yaml

Die Flux-Kustomization musst du nicht von Hand tippen. flux create baut sie, und --export schreibt sie aus, statt sie im Cluster anzulegen:

flux create kustomization notes --source=GitRepository/flux-system \
  --path=./apps/notes --prune=true --interval=5m --export > clusters/lab/notes.yaml
cat clusters/lab/notes.yaml

Erwartet:

---
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
  name: notes
  namespace: flux-system
spec:
  interval: 5m0s
  path: ./apps/notes
  prune: true
  sourceRef:
    kind: GitRepository
    name: flux-system
  • sourceRef zeigt auf dieselbe Quelle wie flux-system, also auf das Fleet-Repo. Eine zweite Quelle brauchst du nicht.
  • path ist relativ zum Wurzelordner des Repos.
  • Mit --export bleibt Git die einzige Wahrheit. Ein flux create ohne --export legt das Objekt nur im Cluster an, und beim nächsten Abgleich von flux-system bliebe es unbemerkt liegen.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Committen und ausrollen

git add -A
git commit -m "notes-api aus Git"
git push

Erwartet (gekürzt):

[main 652cb0c] notes-api aus Git
 6 files changed, 66 insertions(+)
...
To https://github.com/<du>/flux-fleet.git
   3fb103a..652cb0c  main -> main

Innerhalb einer Minute holt Flux den Commit. Ungeduldig? Dann stößt du den Abgleich an:

flux reconcile kustomization flux-system --with-source
flux get kustomizations

Erwartet (gekürzt):

✔ applied revision main@sha1:652cb0c1a76befdab2c3a9c9778668451402ef6c
NAME        REVISION            SUSPENDED   READY   MESSAGE
flux-system main@sha1:652cb0c1  False       True    Applied revision: main@sha1:652cb0c1
notes       main@sha1:652cb0c1  False       True    Applied revision: main@sha1:652cb0c1

Zwei Kustomizations, ein Commit. Die Reihenfolge: flux-system wendet clusters/lab/notes.yaml an, dadurch entsteht die Kustomization notes, und die wendet apps/notes an.

kubectl -n notes rollout status deploy/notes
curl -s localhost:30080/version

Erwartet:

deployment "notes" successfully rolled out
0.5.1

Fortschritt speichern? Kostenlos registrieren

Drill 3: Drift zurückdrehen

Der eilige Kollege aus Tag 0 ist wieder da:

kubectl -n notes set image deploy/notes api=ghcr.io/thomaszachmann/notes-api:0.7.1
kubectl -n notes rollout status deploy/notes
curl -s localhost:30080/version

Erwartet (gekürzt):

deployment.apps/notes image updated
...
0.7.1

Diesmal bleibt es nicht dabei. Spätestens nach fünf Minuten (interval: 5m) gleicht Flux ab. Du ziehst es vor:

flux reconcile kustomization notes
kubectl -n notes rollout status deploy/notes
curl -s localhost:30080/version

Erwartet (gekürzt):

✔ applied revision main@sha1:652cb0c1a76befdab2c3a9c9778668451402ef6c
...
0.5.1
flux events --for Kustomization/notes

Erwartet (gekürzt):

5s   Normal  Progressing             Kustomization/notes  Deployment/notes/notes configured
5s   Normal  ReconciliationSucceeded Kustomization/notes  Reconciliation finished in 899.497735ms, next run in 5m0s

configured heißt: Flux hat am Deployment etwas zurückgesetzt. Bei einem Abgleich ohne Abweichung fehlt diese Zeile.

Dasselbe gilt für jedes Feld, das in Git steht, auch für die Zahl der Replicas:

kubectl -n notes scale deploy notes --replicas=3
flux reconcile kustomization notes
kubectl -n notes get deploy notes

Erwartet (gekürzt):

deployment.apps/notes scaled
...
NAME    READY   UP-TO-DATE   AVAILABLE   AGE
notes   1/1     1            1           4m

Fortschritt speichern? Kostenlos registrieren

Drill 4: Ändern über Git

So sieht ein Update ab heute aus:

sed -i 's/notes-api:0.5.1/notes-api:0.5.3/' apps/notes/deployment.yaml
git commit -am "notes-api 0.5.3"
git push
flux reconcile kustomization notes --with-source
kubectl -n notes rollout status deploy/notes
curl -s localhost:30080/version

Erwartet (gekürzt):

✔ applied revision main@sha1:e6bec635d8c91f12015ea043a19ddb4e1a88927f
...
0.5.3

git log ist jetzt das Protokoll deiner Änderungen am Cluster, mit Autor, Zeit und Grund.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Prune

Was aus Git verschwindet, entfernt Flux auch im Cluster. Nimm den Service heraus:

git rm -q apps/notes/service.yaml
sed -i '/service.yaml/d' apps/notes/kustomization.yaml
git commit -am "notes: Service entfernt"
git push
flux reconcile kustomization notes --with-source
kubectl -n notes get svc

Erwartet (gekürzt):

✔ applied revision main@sha1:71ba4957ccea1ff66aa0010a38f4db6a64c9913a
No resources found in notes namespace.
flux events --for Kustomization/notes | grep deleted

Erwartet:

8s   Normal  Progressing  Kustomization/notes  Service/notes/notes deleted

Zurück holst du den Service mit dem Mittel, das Git für jeden Fehler bereithält:

git revert --no-edit HEAD
git push
flux reconcile kustomization notes --with-source
kubectl -n notes get svc

Erwartet (gekürzt):

[main 6a2ee93] Revert "notes: Service entfernt"
...
NAME    TYPE       CLUSTER-IP     EXTERNAL-IP   PORT(S)        AGE
notes   NodePort   10.43.30.162   <none>        80:30080/TCP   3s

Ein Rollback ist bei GitOps kein eigenes Werkzeug, sondern ein Commit.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

flux get kustomizations

Erwartet: flux-system und notes, beide READY True, mit derselben Revision.

curl -s localhost:30080/version

Erwartet: 0.5.3.

Challenge

Ein Kollege will notes-api auf zwei Replicas stellen und vertippt sich:

sed -i 's/replicas: 1/replicas: zwei/' apps/notes/deployment.yaml
git commit -am "notes: zwei Replicas"
git push

Was passiert mit dem laufenden notes-api? Finde die Fehlermeldung und repariere den Stand.

Hinweis: flux get hat eine Spalte MESSAGE. Und bevor Flux etwas anwendet, macht es einen Probelauf.

Lösung

flux reconcile kustomization flux-system --with-source
flux get kustomization notes

Erwartet (gekürzt):

NAME    REVISION            SUSPENDED   READY   MESSAGE
notes   main@sha1:6a2ee938  False       False   Deployment/notes/notes dry-run failed: failed to create typed patch object (notes/notes; apps/v1, Kind=Deployment): .spec.replicas: expected numeric (int or float), got string
  • READY steht auf False, aber REVISION zeigt noch den alten Commit. Flux prüft den ganzen Ordner per Dry-Run gegen den API-Server, bevor es irgendetwas anwendet. Scheitert ein einziges Objekt, wendet es gar nichts an.
  • notes-api läuft also unverändert weiter:
kubectl -n notes get deploy notes

Erwartet:

NAME    READY   UP-TO-DATE   AVAILABLE   AGE
notes   1/1     1            1           4m30s

Repariert wird, wie immer, über Git:

sed -i 's/replicas: zwei/replicas: 2/' apps/notes/deployment.yaml
git commit -am "notes: zwei Replicas, diesmal als Zahl"
git push
flux reconcile kustomization notes --with-source
kubectl -n notes get deploy notes

Erwartet (gekürzt):

✔ applied revision main@sha1:eb05203916fbb52802e0b86886d26b36c43afa23
NAME    READY   UP-TO-DATE   AVAILABLE   AGE
notes   2/2     2            2           5m36s
  • Ein flux reconcile auf die kaputte Kustomization notes hätte übrigens gewartet, bis sie bereit ist, also bis zum Ablauf der Wartezeit von fünf Minuten. Deshalb stößt die Lösung flux-system an: Das holt den Commit, und notes folgt von selbst.

Der Stand nach der Challenge liegt im Begleitcode:

diff -r ~/flux-lab/fleet/apps ~/flux-lab/code/loesung/tag02/apps

Erwartet: keine Ausgabe.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Replicas und Autoscaler: Flux setzt jedes Feld zurück, das in Git steht. Skaliert ein HorizontalPodAutoscaler das Deployment, lässt du replicas in Git weg. Sonst streiten sich HPA und Flux bei jedem Abgleich.
  • Notfall-Eingriff: Muss jemand im Störfall von Hand eingreifen, hält flux suspend kustomization notes den Abgleich an, flux resume setzt ihn fort (Tag 4). Ohne suspend dreht Flux den Eingriff nach dem nächsten Intervall zurück.
  • Branch-Schutz: Wer auf main pushen darf, darf den Cluster ändern. Im Betrieb schützt du main und lässt Änderungen nur über Pull Requests mit Review zu.