Zum Inhalt springen
Trainingslager IT-Trainingslager

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.yaml im 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-system

Die 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: werk

Zwei 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.io

Erwartet (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"; echo

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

Fleet beobachtet das Repo notes-fleet

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 api

Erwartet (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}'; echo

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

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

GitRepo notes mit Bundle und 14 Ressourcen

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

kubectl -n fleet-default get gitrepos.fleet.cattle.io notes

Erwartet: 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 api

Erwartet: 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}'; echo

Erwartet: 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 --oneline

Erwartet (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-default ist ein Workspace. Teams bekommen eigene Workspaces mit eigenen Clustern und Rechten; GitRepoRestrictions begrenzen, 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.