Tag 8: Fleet – GitOps mit Gitea
Ziel: notes auf werk nicht mehr per Klick, sondern aus einem Git-Repository ausrollen, Änderungen per Commit einspielen und Handänderungen im Cluster erkennen und zurücksetzen. · Dauer: ca. 75 min · Voraussetzung: Tag 7
Briefing
- Fleet ist Ranchers GitOps-Werkzeug und seit Tag 3 installiert. Es beobachtet Git-Repositories und rollt, was darin liegt, auf die gewünschten Cluster aus.
- Ein GitRepo-Objekt im local-Cluster sagt: welches Repo, welcher Branch, welche Ziel-Cluster. Fleet macht daraus Bundles und pro Cluster ein BundleDeployment, das der fleet-agent im Ziel umsetzt.
fleet.yamlim Repo beschreibt, was ausgerollt wird, hier: das Chart notes aus dem Gitea-Helm-Repo mit Werten.- Weicht der Cluster vom Repo ab, ist das Drift. Fleet meldet sie und setzt sie auf Wunsch zurück.
Mac: git push ──► Gitea lab/notes-fleet ◄── pollt alle 15 s ── Fleet (local)
GitRepo notes
Bundle notes
│
Cluster werk: fleet-agent ◄────┘
helm install/upgrade notes (Namespace notes)
Drill 1: Ein Repository in Gitea
source ~/rancher-lab/setup/env.sh
mkdir -p "$LAB/tag08" && cd "$LAB/tag08"
cp "$LAB/code/tag08/gitrepo.yaml" "$LAB/tag07/lab-ca.crt" .
G="https://gitea.$RANCHER.sslip.io"
curl -s --cacert lab-ca.crt -u lab:lab-gitea-pw-123 -X POST \
-H 'Content-Type: application/json' "$G/api/v1/user/repos" \
-d '{"name":"notes-fleet","description":"notes per Fleet","private":true,
"default_branch":"main"}' | jq -c '{full_name, private}'Erwartet (gekürzt, Namen, IPs und Zeiten weichen bei dir ab):
{"full_name":"lab/notes-fleet","private":true}
Das Repo ist privat. Fleet braucht also gleich Zugangsdaten, so wie in jedem echten Unternehmen.
Fortschritt speichern? Kostenlos registrieren
Drill 2: fleet.yaml
# notes-fleet/fleet.yaml – erster Commit (Tag 8, Drill 2); Drill 5 senkt replicas auf 2
# Vorlage: RANCHER_IP ersetzt Tag 8, Drill 2 per sed durch die Adresse der VM rancher.
defaultNamespace: notes
helm:
releaseName: notes
repo: https://gitea.RANCHER_IP.sslip.io/api/packages/lab/helm
chart: notes
version: 0.3.1
values:
api:
replicas: 3
image:
repository: gitea.RANCHER_IP.sslip.io/lab/notes-api
web:
image:
repository: gitea.RANCHER_IP.sslip.io/lab/notes-web
worker:
image:
repository: gitea.RANCHER_IP.sslip.io/lab/notes-worker
gateway:
enabled: false
networkPolicy:
gatewayNamespace: kube-systemDie Werte sind dieselben wie in values-werk.yaml aus Tag
7, jetzt aber in Git.
git -c http.sslCAInfo="$PWD/lab-ca.crt" clone \
"https://lab:lab-gitea-pw-123@gitea.$RANCHER.sslip.io/lab/notes-fleet.git"
cd notes-fleet
git config http.sslCAInfo ../lab-ca.crt
git config user.name lab && git config user.email [email protected]
sed "s/RANCHER_IP/$RANCHER/g" "$LAB/code/tag08/notes-fleet/fleet.yaml" > fleet.yaml
git add fleet.yaml && git commit -qm "notes per Fleet" && git push -q origin HEAD:main
git log --oneline
cd ..Erwartet:
Cloning into 'notes-fleet'...
warning: You appear to have cloned an empty repository.
101f1c6 notes per Fleet
Sicherheit: Das Passwort in der Clone-URL landet in
.git/config. Im Labor ist das bequem; in Produktion nimmst du einen Zugangs-Token mit Ablaufdatum oder SSH.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Von der App zu Git
Die App aus Tag 7 und Fleet sollen nicht um dasselbe Release streiten. Entferne die App. Das Volume der Datenbank bleibt dabei stehen, wie in „Kubernetes zum Anfassen”, Tag 15, Runde 10:
export KUBECONFIG="$LAB/kube/werk.yaml"
helm -n notes uninstall notes --wait
kubectl -n notes get pvc
export KUBECONFIG="$LAB/kube/rancher.yaml"Erwartet (gekürzt):
release "notes" uninstalled
NAME STATUS VOLUME CAPACITY …
data-db-0 Bound pvc-d529ef36-d0ad-4d66-a49d-d513f77f4e34 1Gi …
Fortschritt speichern? Kostenlos registrieren
Drill 4: Das GitRepo
# tag08/gitrepo.yaml – Stand Ende Tag 8: Fleet beobachtet lab/notes-fleet in Gitea
# Vorlage: RANCHER_IP und CA_BUNDLE (base64 der Labor-CA) ersetzt Drill 4 per sed.
# Das Secret gitea-helm (Helm-Repo mit CA) legt Drill 4 per kubectl an.
apiVersion: v1
kind: Secret
metadata:
name: gitea-git
namespace: fleet-default
type: kubernetes.io/basic-auth
stringData:
username: lab
password: lab-gitea-pw-123
---
apiVersion: fleet.cattle.io/v1alpha1
kind: GitRepo
metadata:
name: notes
namespace: fleet-default
spec:
repo: https://gitea.RANCHER_IP.sslip.io/lab/notes-fleet.git
branch: main
clientSecretName: gitea-git
helmSecretName: gitea-helm
caBundle: CA_BUNDLE
pollingInterval: 15s
correctDrift:
enabled: true # ab Drill 7: Handänderungen im Cluster zurücksetzen
targets:
- clusterName: werkZwei Secrets, zwei Zwecke: gitea-git öffnet das
Git-Repo, gitea-helm das Helm-Repo, aus dem
fleet.yaml das Chart holt. caBundle
(base64-kodiertes PEM) gilt für Git, cacerts im Helm-Secret
für das Helm-Repo. Lass correctDrift für den Moment weg;
das schaltest du in Drill 7 ein.
kubectl -n fleet-default create secret generic gitea-helm --from-literal=username=lab \
--from-literal=password=lab-gitea-pw-123 --from-file=cacerts=lab-ca.crt
sed -i '' -e "s|RANCHER_IP|$RANCHER|" -e "s|CA_BUNDLE|$(base64 -i lab-ca.crt)|" \
gitrepo.yaml
grep -v -E 'correctDrift:|enabled: true' gitrepo.yaml > gitrepo-ohne-drift.yaml
kubectl apply -f gitrepo-ohne-drift.yaml
kubectl -n fleet-default wait gitrepos.fleet.cattle.io/notes --for=condition=Ready \
--timeout=300s
kubectl -n fleet-default get gitrepos.fleet.cattle.ioErwartet (gekürzt):
secret/gitea-helm created
secret/gitea-git created
gitrepo.fleet.cattle.io/notes created
gitrepo.fleet.cattle.io/notes condition met
NAME REPO COMMIT BUNDLEDEPLOYMENTS-READY
notes https://gitea.….sslip.io/lab/notes-fleet.git 101f1c6cda1c… 1/1
Nach einer Minute steht notes wieder, diesmal von Fleet installiert:
helm --kubeconfig "$LAB/kube/werk.yaml" -n notes list
curl -s "http://notes.$WERK1.sslip.io/api/notes"; echoErwartet (gekürzt):
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
notes notes 2 2026-… deployed notes-0.3.1 0.2.0
[{"id":"c0c70ff3-…","text":"aus dem eigenen Katalog"}]
Die Notiz aus Tag 7 ist noch da: Das neue Release hat das alte Volume übernommen. In der Oberfläche findest du das GitRepo unter Continuous Delivery › Git Repos:
Fortschritt speichern? Kostenlos registrieren
Drill 5: Änderung per Commit
Zwei api-Repliken genügen. Die Änderung passiert nur in Git:
cd notes-fleet
sed -i '' 's/ replicas: 3/ replicas: 2/' fleet.yaml
git commit -qam "api: 2 Repliken" && git push -q origin HEAD:main
git log --oneline -1
cd ..
kubectl --kubeconfig "$LAB/kube/werk.yaml" -n notes get deploy apiErwartet (gekürzt, nach etwa 20 Sekunden):
b92ca6e api: 2 Repliken
NAME READY UP-TO-DATE AVAILABLE AGE
api 2/2 2 2 3m
Fleet fragt Gitea alle 15 Sekunden nach neuen Commits
(pollingInterval). Statt zu pollen kann Gitea auch per
Webhook Bescheid geben.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Drift
Jemand skaliert im Cluster von Hand:
kubectl --kubeconfig "$LAB/kube/werk.yaml" -n notes scale deploy api --replicas=5
kubectl -n fleet-default get gitrepos.fleet.cattle.io notes \
-o custom-columns=READY:.status.display.readyBundleDeployments\
,STATE:.status.display.state
kubectl -n fleet-default get bundles.fleet.cattle.io notes \
-o jsonpath='{.status.summary.nonReadyResources[0].modifiedStatus}'; echoErwartet (gekürzt, nach etwa 20 Sekunden):
deployment.apps/api scaled
READY STATE
0/1 Modified
[{"apiVersion":"apps/v1","kind":"Deployment","name":"api","namespace":"notes",
"patch":"{\"spec\":{\"replicas\":2}}"}]
Fleet bemerkt die Abweichung und zeigt sogar den Patch, der den Soll-Zustand wiederherstellen würde. Es greift aber nicht ein: Ohne weitere Einstellung meldet Fleet Drift nur.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Drift zurücksetzen
kubectl -n fleet-default patch gitrepos.fleet.cattle.io notes --type merge \
-p '{"spec":{"correctDrift":{"enabled":true}}}'
kubectl --kubeconfig "$LAB/kube/werk.yaml" -n notes get deploy api
kubectl --kubeconfig "$LAB/kube/werk.yaml" -n notes scale deploy api --replicas=4
kubectl --kubeconfig "$LAB/kube/werk.yaml" -n notes get deploy api
helm --kubeconfig "$LAB/kube/werk.yaml" -n notes history notes | tail -2Erwartet (gekürzt, zwischen den Befehlen jeweils gut zehn Sekunden):
gitrepo.fleet.cattle.io/notes patched
NAME READY UP-TO-DATE AVAILABLE AGE
api 2/2 2 2 4m
deployment.apps/api scaled
NAME READY UP-TO-DATE AVAILABLE AGE
api 2/2 2 2 4m
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION
4 … superseded notes-0.3.1 0.2.0 Rollback to 3
5 … deployed notes-0.3.1 0.2.0 Rollback to 4
Nach wenigen Sekunden sind es wieder zwei Repliken. Fleet setzt Drift
mit einem helm rollback auf die letzte Revision zurück; das
zeigt die Historie. Ab jetzt gilt: Was nicht in Git steht, bleibt nicht.
Die vollständige gitrepo.yaml im Begleitcode enthält
correctDrift deshalb von Anfang an.
Die Detailseite des GitRepos zeigt Bundles und Ressourcen:
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
kubectl -n fleet-default get gitrepos.fleet.cattle.io notesErwartet: 1/1 BundleDeployments bereit, der letzte
Commit ist bekannt.
NAME REPO COMMIT BUNDLEDEPLOYMENTS-READY
notes https://gitea.….sslip.io/lab/notes-fleet.git b92ca6ed6856… 1/1
kubectl --kubeconfig "$LAB/kube/werk.yaml" -n notes get deploy apiErwartet: zwei Repliken, wie in Git.
NAME READY UP-TO-DATE AVAILABLE AGE
api 2/2 2 2 6m
kubectl -n fleet-default get gitrepos.fleet.cattle.io notes \
-o jsonpath='{.spec.correctDrift.enabled}'; echoErwartet: true.
true
Challenge
Ein Kollege will vor dem Wochenende keine Änderungen mehr im Cluster,
Commits sollen aber weiter möglich sein. Halte Fleet an, ändere die
Repliken in Git auf 3, prüfe, dass nichts passiert, und lass Fleet
weiterlaufen. Nimm die Änderung danach mit git revert
zurück.
Hinweis: Das GitRepo kennt
spec.paused.
Lösung
kubectl -n fleet-default patch gitrepos.fleet.cattle.io notes --type merge \
-p '{"spec":{"paused":true}}'
cd notes-fleet
sed -i '' 's/ replicas: 2/ replicas: 3/' fleet.yaml
git commit -qam "api: 3 Repliken" && git push -q origin HEAD:main
cd ..
kubectl -n fleet-default get bundles.fleet.cattle.io notes \
-o jsonpath='{.status.display.state}'; echo
kubectl --kubeconfig "$LAB/kube/werk.yaml" -n notes get deploy api \
-o jsonpath='{.spec.replicas}'; echo
kubectl -n fleet-default patch gitrepos.fleet.cattle.io notes --type merge \
-p '{"spec":{"paused":false}}'
cd notes-fleet && git revert --no-edit HEAD && git push -q origin HEAD:main && cd ..
git -C notes-fleet log --onelineErwartet (gekürzt):
gitrepo.fleet.cattle.io/notes patched
WaitApplied
2
gitrepo.fleet.cattle.io/notes patched
[main 2baba8c] Revert "api: 3 Repliken"
…
2baba8c Revert "api: 3 Repliken"
b213bbf api: 3 Repliken
b92ca6e api: 2 Repliken
101f1c6 notes per Fleet
Angehalten liest Fleet den neuen Commit zwar, wendet ihn aber nicht
an (WaitApplied). Nach dem Fortsetzen kommen drei Repliken,
eine halbe Minute nach dem Revert wieder zwei. Die Geschichte im Repo
erzählt genau, was wann passiert ist.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Workspaces:
fleet-defaultist ein Workspace. Teams bekommen eigene Workspaces mit eigenen Clustern und Rechten;GitRepoRestrictionsbegrenzen, welche Repos und Namespaces erlaubt sind. - Webhooks: Statt alle 15 Sekunden zu pollen, meldet sich das Git-System per Webhook bei Fleet. Das spart Last und ist schneller.
- Zugang: Deploy-Keys (SSH) oder Tokens mit Leserechten statt Benutzerpasswort. Das Helm-Repo bekommt eigene, ebenso eingeschränkte Zugangsdaten.
- Argo CD oder Fleet: Fleet ist in Rancher eingebaut und für sehr viele Cluster gedacht; Argo CD hat die reichere Oberfläche für einzelne Anwendungen.
- Freigaben: Änderungen kommen per Merge Request mit Review in den Branch, den Fleet beobachtet. Der Cluster selbst wird nicht mehr von Hand angefasst.