Zum Inhalt springen
Trainingslager IT-Trainingslager

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, --help und die offizielle Doku, nicht die Tage 1–15. Die Lösungsdateien liegen in code/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 notes

Erwartet (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.yaml

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

Erwartet:

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-b
kubectl --kubeconfig "$W" apply -f ns-team-b.yaml

Erwartet:

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 .version

Erwartet (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.yaml

Erwartet (gekürzt):

{"full_name":"lab/team-b-fleet"}
Cloning into 'team-b-fleet'...
…
gitrepo.fleet.cattle.io/podinfo created

Achtung: Wer podinfo/fleet.yaml ins Repo notes-fleet legt, erlebt eine Überraschung: Das GitRepo notes hat keine paths und rollt jedes fleet.yaml im Repo aus, auch das neue, und das auf alle Cluster seiner Gruppe. Zwei GitRepos streiten dann um dasselbe Release. Ein Repo pro Team oder klare paths vermeiden 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=3

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

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

  1. Was unterscheidet ein importiertes Cluster von einem angelegten?
  2. Warum muss Rancher ein Cluster nicht erreichen können, um es zu verwalten?
  3. Wozu gibt es clusters.provisioning.cattle.io und clusters.management.cattle.io?
  4. Was macht der rancher-system-agent auf einem Node?
  5. Was passiert mit notes auf einem Cluster, das seine Fleet-Gruppe verlässt?
  6. Warum lässt sich die StorageClass von Postgres nicht einfach in den Values ändern?
  7. Wo erzwingt Rancher die Support-Matrix der Kubernetes-Versionen, wo nicht?
  8. Was sichert ein Rancher-Backup, was ein etcd-Snapshot, was keins von beiden?
  9. Wie erreichst du werk, wenn Rancher ausgefallen ist?
  10. Warum bekommt ein zweiter Namespace im Projekt notes eine Quota von null?

Antworten

  1. Ein importiertes Cluster existiert schon, Rancher verwaltet es nur. Ein angelegtes baut Rancher selbst, mit RKE2 und Plänen für jeden Node.
  2. Der cattle-cluster-agent im Ziel baut die Verbindung zu Rancher auf, nicht umgekehrt.
  3. provisioning beschreibt, wie ein Cluster entsteht und aussieht; management ist Ranchers interne Sicht auf jedes verwaltete Cluster, mit ID c-m-….
  4. Er holt Pläne von Rancher (Dateien, Dienste, Versionen) und setzt sie um, etwa RKE2 installieren, konfigurieren und aktualisieren.
  5. Fleet entfernt das Release; das Volume bleibt. Mit dem Label kommt notes zurück.
  6. Die volumeClaimTemplates eines StatefulSets sind unveränderlich. Der Umzug braucht Backup, Neuinstallation und Restore.
  7. Nur die Oberfläche bietet ausschließlich unterstützte Versionen an. API, kubectl und GitOps nehmen jede Version an.
  8. Rancher-Backup: Rancher-Objekte im local-Cluster. etcd-Snapshot: alle Kubernetes-Objekte eines Clusters. Daten in Volumes sichert keins von beiden.
  9. Über den Authorized Cluster Endpoint, den direkten Kontext werk-werk1.
  10. Das Projektbudget (30 Pods) reicht nicht für zwei Namespace-Anteile zu je 20 Pods.