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 applybrauchst du für notes-api nicht mehr. - Dafür bekommt notes-api eine eigene Kustomization.
Sie zeigt auf den Ordner
apps/notesim Fleet-Repo. Das Objekt selbst liegt inclusters/lab, und das wendetflux-systemohnehin 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/notesErwartet:
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.yamlErwartet:
---
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
sourceRefzeigt auf dieselbe Quelle wieflux-system, also auf das Fleet-Repo. Eine zweite Quelle brauchst du nicht.pathist relativ zum Wurzelordner des Repos.- Mit
--exportbleibt Git die einzige Wahrheit. Einflux createohne--exportlegt das Objekt nur im Cluster an, und beim nächsten Abgleich vonflux-systembliebe es unbemerkt liegen.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Committen und ausrollen
git add -A
git commit -m "notes-api aus Git"
git pushErwartet (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 kustomizationsErwartet (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/versionErwartet:
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/versionErwartet (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/versionErwartet (gekürzt):
✔ applied revision main@sha1:652cb0c1a76befdab2c3a9c9778668451402ef6c
...
0.5.1
flux events --for Kustomization/notesErwartet (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 notesErwartet (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/versionErwartet (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 svcErwartet (gekürzt):
✔ applied revision main@sha1:71ba4957ccea1ff66aa0010a38f4db6a64c9913a
No resources found in notes namespace.
flux events --for Kustomization/notes | grep deletedErwartet:
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 svcErwartet (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 kustomizationsErwartet: flux-system und notes, beide
READY True, mit derselben Revision.
curl -s localhost:30080/versionErwartet: 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 pushWas 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 notesErwartet (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
READYsteht aufFalse, aberREVISIONzeigt 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 notesErwartet:
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 notesErwartet (gekürzt):
✔ applied revision main@sha1:eb05203916fbb52802e0b86886d26b36c43afa23
NAME READY UP-TO-DATE AVAILABLE AGE
notes 2/2 2 2 5m36s
- Ein
flux reconcileauf die kaputte Kustomizationnoteshätte übrigens gewartet, bis sie bereit ist, also bis zum Ablauf der Wartezeit von fünf Minuten. Deshalb stößt die Lösungflux-systeman: Das holt den Commit, undnotesfolgt von selbst.
Der Stand nach der Challenge liegt im Begleitcode:
diff -r ~/flux-lab/fleet/apps ~/flux-lab/code/loesung/tag02/appsErwartet: 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
replicasin 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 notesden Abgleich an,flux resumesetzt ihn fort (Tag 4). Ohnesuspenddreht Flux den Eingriff nach dem nächsten Intervall zurück. - Branch-Schutz: Wer auf
mainpushen darf, darf den Cluster ändern. Im Betrieb schützt dumainund lässt Änderungen nur über Pull Requests mit Review zu.