Anhang B: Abschlussprüfung
Ziel: Das Buch ohne Anleitung anwenden: ein neues Team auf werk einrichten, ihm eine Anwendung per GitOps bereitstellen, Rechte prüfen und alles sauber wieder abbauen, dazu ein Wissensteil. · Dauer: ca. 120 min · Voraussetzung: Tag 15
Spielregeln
- Jede Übung nennt Anforderungen und einen Prüfblock aus einzelnen Befehlen mit erwarteter Ausgabe. Bestanden ist sie, wenn deine Ausgabe passt. Die Lösung liest du erst danach.
- Die Übungen bauen aufeinander auf und laufen in
~/rancher-lab/anhb. notes auf k3s und werk läuft die ganze Zeit weiter und darf nicht leiden. - Erlaubt sind Anhang A,
kubectl explain,--helpund die offizielle Doku, nicht die Tage 1–15. Die Lösungsdateien liegen incode/anhb/loesung/. - Bestanden hast du mit sechs passenden Prüfblöcken und mindestens 8 von 10 Punkten im Wissensteil.
source ~/rancher-lab/setup/env.sh
mkdir -p "$LAB/anhb" && cd "$LAB/anhb"
export KUBECONFIG="$LAB/kube/rancher.yaml"
R="https://rancher.$RANCHER.sslip.io"
H="Authorization: Bearer $(cat "$LAB/rancher-token")"
W="$LAB/kube/werk.yaml"
W_ID=$(kubectl -n fleet-default get clusters.provisioning.cattle.io werk \
-o jsonpath='{.status.clusterName}')
echo "$W_ID"Erwartet (gekürzt, IDs, Namen und Zeiten weichen bei dir ab):
c-m-ct8fr7hj
Ist der Login-Token aus Tag 5 älter als 16 Stunden, hol dir zuerst einen neuen (Tag 5, Drill 7).
Übung 1: Ein Projekt für team-b
Tag 6. Leg im Cluster werk ein Projekt p-team-b
(Anzeigename team-b) an: höchstens 10 Pods, 1 CPU an
Requests, 2 Gi Speicher-Limit, für das ganze Projekt wie für jeden
Namespace darin, dazu Container-Standardwerte von 20m CPU, 32 Mi und 128
Mi Limit.
Prüfblock:
kubectl -n "$W_ID" get projects.management.cattle.io p-team-b \
-o custom-columns=NAME:.metadata.name,DISPLAY:.spec.displayName
kubectl get ns "$W_ID-p-team-b"Erwartet:
NAME DISPLAY
p-team-b team-b
NAME STATUS AGE
c-m-ct8fr7hj-p-team-b Active 10s
Lösung
Die Datei team-b.yaml enthält das Projekt und gleich die
Rechte für Übung 2:
# anhb/loesung/team-b.yaml (Ausschnitt) – Anhang B, Übung 1 und 2
apiVersion: management.cattle.io/v3
kind: Project
metadata:
name: p-team-b
namespace: WERK_ID
spec:
clusterName: WERK_ID
displayName: team-b
resourceQuota:
limit: {pods: "10", requestsCpu: "1000m", limitsMemory: "2Gi"}
namespaceDefaultResourceQuota:
limit: {pods: "10", requestsCpu: "1000m", limitsMemory: "2Gi"}
containerDefaultResourceLimit:
requestsCpu: "20m"
requestsMemory: "32Mi"
limitsMemory: "128Mi"Gesamtbudget und Anteil pro Namespace sind gleich groß: Es gibt genau einen Namespace. Ein zweiter bekäme eine Quota von null (Tag 6, Challenge).
Fortschritt speichern? Kostenlos registrieren
Übung 2: Ein Benutzer, der nur liest
Tag 6 und 14. Lege den lokalen Benutzer ben (Passwort
lab-user-pw-456) an. Er darf sich anmelden und im Projekt
team-b alles lesen, aber nichts ändern, und von notes nichts sehen. Hol
ihm eine eigene kubeconfig für werk.
Prüfblock:
B="$LAB/kube/werk-ben.yaml"
kubectl --kubeconfig "$B" auth can-i list pods -n team-b
kubectl --kubeconfig "$B" auth can-i create deployments -n team-b
kubectl --kubeconfig "$B" auth can-i list pods -n notesErwartet (nach Übung 3, wenn der Namespace existiert):
yes
no
no
Lösung
curl -sk -X POST -H "$H" -H 'Content-Type: application/json' "$R/v3/users" \
-d '{"username":"ben","name":"Ben Betrieb","password":"lab-user-pw-456",
"mustChangePassword":false,"enabled":true}' | jq -c '{id, username}'
f='{range .items[?(@.username=="ben")]}{.metadata.name}{end}'
BEN=$(kubectl get users.management.cattle.io -o jsonpath="$f")
cp "$LAB/code/anhb/loesung/"*.yaml .
sed -i '' -e "s/WERK_ID/$W_ID/g" -e "s/BEN_ID/$BEN/g" team-b.yaml ns-team-b.yaml
kubectl apply -f team-b.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Active namespace/"$W_ID-p-team-b" \
--timeout=60s
kubectl apply -f team-b.yamlErwartet (gekürzt):
{"id":"u-klpvd","username":"ben"}
project.management.cattle.io/p-team-b created
globalrolebinding.management.cattle.io/ben-user-base created
Error from server (NotFound): error when creating "team-b.yaml": namespaces
"c-m-ct8fr7hj-p-team-b" not found
namespace/c-m-ct8fr7hj-p-team-b condition met
…
projectroletemplatebinding.management.cattle.io/ben-read-only created
Der Namespace des Projekts im local-Cluster entsteht erst kurz nach
dem Projekt. Die Bindung darin scheitert beim ersten Mal; ein zweites
apply holt sie nach. Die Rolle read-only gibt
Lesen ohne Ändern. Die kubeconfig entsteht wie in Tag 6, Drill 6:
( umask 077
curl -sk -X POST "$R/v3-public/localProviders/local?action=login" \
-H 'Content-Type: application/json' \
-d '{"username":"ben","password":"lab-user-pw-456","responseType":"json"}' \
| jq -r .token > ben-token )
curl -sk -X POST -H "Authorization: Bearer $(cat ben-token)" \
"$R/v3/clusters/$W_ID?action=generateKubeconfig" | jq -r .config > "$B"
chmod 600 "$B"Fortschritt speichern? Kostenlos registrieren
Übung 3: Der Namespace
Tag 6. Leg in werk den Namespace team-b im Projekt
team-b an. Quota und LimitRange soll Rancher selbst setzen.
Prüfblock:
kubectl --kubeconfig "$W" -n team-b get resourcequotaErwartet:
NAME REQUEST LIMIT AGE
default-98k5s pods: 0/10, requests.cpu: 0/1 limits.memory: 0/2Gi 9s
Lösung
# anhb/loesung/ns-team-b.yaml – Anhang B, Übung 3: Namespace im Projekt team-b
apiVersion: v1
kind: Namespace
metadata:
name: team-b
annotations:
field.cattle.io/projectId: WERK_ID:p-team-bkubectl --kubeconfig "$W" apply -f ns-team-b.yamlErwartet:
namespace/team-b created
Ohne Annotation läge der Namespace in keinem Projekt, und ben sähe
ihn nicht. Pod Security bekommt er vom Cluster:
rancher-restricted aus Tag 14 gilt auch hier.
Fortschritt speichern? Kostenlos registrieren
Übung 4: podinfo per GitOps
Tag 8 und 9. Stell team-b die Demo-Anwendung podinfo bereit, Chart
oci://ghcr.io/stefanprodan/charts/podinfo in Version
6.17.0, zwei Repliken, nur auf werk, mit Drift-Korrektur, aus einem
eigenen Gitea-Repo lab/team-b-fleet. notes darf davon
nichts mitbekommen.
Prüfblock:
kubectl -n fleet-default get gitrepos.fleet.cattle.io
kubectl --kubeconfig "$W" -n team-b exec deploy/podinfo -- \
wget -qO- localhost:9898/version | jq -r .versionErwartet (gekürzt):
NAME REPO COMMIT BUNDLEDEPLOYMENTS-READY
notes https://gitea.….sslip.io/lab/notes-fleet.git … 2/2
podinfo https://gitea.….sslip.io/lab/team-b-fleet.git … 1/1
6.17.0
Lösung
# fleet.yaml (Repo lab/team-b-fleet) – Anhang B, Übung 4: podinfo für restricted
defaultNamespace: team-b
helm:
releaseName: podinfo
chart: oci://ghcr.io/stefanprodan/charts/podinfo
version: 6.17.0
values:
replicaCount: 2
resources:
requests: {cpu: 20m, memory: 32Mi}
limits: {memory: 128Mi}
podSecurityContext:
runAsNonRoot: true
runAsUser: 100
runAsGroup: 101
seccompProfile:
type: RuntimeDefault
securityContext:
allowPrivilegeEscalation: false
readOnlyRootFilesystem: true
capabilities:
drop: [ALL]Ohne den Sicherheitskontext lehnt rancher-restricted die
Pods ab („Kubernetes zum Anfassen”, Tag 9, Challenge). Das GitRepo
gitrepo-podinfo.yaml gleicht dem aus Tag 8, mit dem neuen
Repo und clusterName: werk als Ziel.
G="https://gitea.$RANCHER.sslip.io"
CA="$LAB/tag07/lab-ca.crt"
curl -s --cacert "$CA" -u lab:lab-gitea-pw-123 -X POST \
-H 'Content-Type: application/json' "$G/api/v1/user/repos" \
-d '{"name":"team-b-fleet","private":true,"default_branch":"main"}' \
| jq -c '{full_name}'
git -c http.sslCAInfo="$CA" clone \
"https://lab:lab-gitea-pw-123@gitea.$RANCHER.sslip.io/lab/team-b-fleet.git"
cd team-b-fleet
git config http.sslCAInfo "$CA"
git config user.name lab && git config user.email [email protected]
cp ../podinfo/fleet.yaml . && git add fleet.yaml
git commit -qm "podinfo für team-b" && git push -q origin HEAD:main
cd ..
sed -i '' -e "s|RANCHER_IP|$RANCHER|" -e "s|CA_BUNDLE|$(base64 -i "$CA")|" \
gitrepo-podinfo.yaml
kubectl apply -f gitrepo-podinfo.yamlErwartet (gekürzt):
{"full_name":"lab/team-b-fleet"}
Cloning into 'team-b-fleet'...
…
gitrepo.fleet.cattle.io/podinfo created
Achtung: Wer
podinfo/fleet.yamlins Reponotes-fleetlegt, erlebt eine Überraschung: Das GitReponoteshat keinepathsund rollt jedesfleet.yamlim Repo aus, auch das neue, und das auf alle Cluster seiner Gruppe. Zwei GitRepos streiten dann um dasselbe Release. Ein Repo pro Team oder klarepathsvermeiden das.
Im Test zeigte das GitRepo minutenlang 0/1 mit
Available: 0/2, obwohl beide Pods liefen. Ein erzwungener
Abgleich bringt den Status auf den Stand:
kubectl -n fleet-default patch gitrepos.fleet.cattle.io podinfo --type merge \
-p '{"spec":{"forceSyncGeneration":1}}'Fortschritt speichern? Kostenlos registrieren
Übung 5: Was ben sieht
Tag 6 und 14. Beweise mit bens kubeconfig, dass er podinfo sieht, aber nicht skalieren darf.
Prüfblock: die beiden Befehle der Lösung.
Lösung
kubectl --kubeconfig "$B" -n team-b get deploy podinfo
kubectl --kubeconfig "$B" -n team-b scale deploy podinfo --replicas=3Erwartet (gekürzt):
NAME READY UP-TO-DATE AVAILABLE AGE
podinfo 2/2 2 2 5m11s
Error from server (Forbidden): deployments.apps "podinfo" is forbidden: User "u-klpvd"
cannot patch resource "deployments/scale" in API group "apps" in the namespace "team-b"
Lesen ja, ändern nein. Selbst wenn ben skalieren dürfte, setzte die Drift-Korrektur den Stand aus Git wieder durch.
Fortschritt speichern? Kostenlos registrieren
Übung 6: Sauber abbauen
Tag 6, 8 und 9. Entferne team-b vollständig: Anwendung, Namespace, Projekt, Benutzer. notes muss weiterlaufen.
Prüfblock:
kubectl -n fleet-default get gitrepos.fleet.cattle.io
kubectl get ns "$W_ID-p-team-b"
kubectl get users.management.cattle.io -o custom-columns=USER:.username \
| grep -c '^ben$'Erwartet:
NAME REPO COMMIT BUNDLEDEPLOYMENTS-READY
notes https://gitea.….sslip.io/lab/notes-fleet.git … 2/2
Error from server (NotFound): namespaces "c-m-ct8fr7hj-p-team-b" not found
0
Lösung
kubectl -n fleet-default delete gitrepos.fleet.cattle.io podinfo
helm --kubeconfig "$W" -n team-b list
kubectl --kubeconfig "$W" delete ns team-b
kubectl -n "$W_ID" delete projects.management.cattle.io p-team-b
kubectl delete users.management.cattle.io "$BEN"
rm -f "$B" ben-tokenErwartet (gekürzt, helm list nach einigen Sekunden
leer):
gitrepo.fleet.cattle.io "podinfo" deleted from fleet-default namespace
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
namespace "team-b" deleted
project.management.cattle.io "p-team-b" deleted from c-m-ct8fr7hj namespace
user.management.cattle.io "u-klpvd" deleted
Ohne GitRepo räumt Fleet das Release in wenigen Sekunden ab. Mit dem Projekt verschwindet sein Namespace im local-Cluster samt Bindungen, mit dem Benutzer seine globale Rolle. Die Datei mit bens kubeconfig löschst du selbst; ihr Token ist mit dem Benutzer ohnehin ungültig.
Fortschritt speichern? Kostenlos registrieren
Wissensteil
Je ein Punkt. Antworten unten.
- Was unterscheidet ein importiertes Cluster von einem angelegten?
- Warum muss Rancher ein Cluster nicht erreichen können, um es zu verwalten?
- Wozu gibt es
clusters.provisioning.cattle.ioundclusters.management.cattle.io? - Was macht der rancher-system-agent auf einem Node?
- Was passiert mit notes auf einem Cluster, das seine Fleet-Gruppe verlässt?
- Warum lässt sich die StorageClass von Postgres nicht einfach in den Values ändern?
- Wo erzwingt Rancher die Support-Matrix der Kubernetes-Versionen, wo nicht?
- Was sichert ein Rancher-Backup, was ein etcd-Snapshot, was keins von beiden?
- Wie erreichst du werk, wenn Rancher ausgefallen ist?
- Warum bekommt ein zweiter Namespace im Projekt notes eine Quota von null?
Antworten
- Ein importiertes Cluster existiert schon, Rancher verwaltet es nur. Ein angelegtes baut Rancher selbst, mit RKE2 und Plänen für jeden Node.
- Der cattle-cluster-agent im Ziel baut die Verbindung zu Rancher auf, nicht umgekehrt.
provisioningbeschreibt, wie ein Cluster entsteht und aussieht;managementist Ranchers interne Sicht auf jedes verwaltete Cluster, mit IDc-m-….- Er holt Pläne von Rancher (Dateien, Dienste, Versionen) und setzt sie um, etwa RKE2 installieren, konfigurieren und aktualisieren.
- Fleet entfernt das Release; das Volume bleibt. Mit dem Label kommt notes zurück.
- Die
volumeClaimTemplateseines StatefulSets sind unveränderlich. Der Umzug braucht Backup, Neuinstallation und Restore. - Nur die Oberfläche bietet ausschließlich unterstützte Versionen an.
API,
kubectlund GitOps nehmen jede Version an. - Rancher-Backup: Rancher-Objekte im local-Cluster. etcd-Snapshot: alle Kubernetes-Objekte eines Clusters. Daten in Volumes sichert keins von beiden.
- Über den Authorized Cluster Endpoint, den direkten Kontext
werk-werk1. - Das Projektbudget (30 Pods) reicht nicht für zwei Namespace-Anteile zu je 20 Pods.