Anhang B: Abschlussprüfung
Ziel: Vier Aufgaben ohne Anleitung, die alles aus dem Buch verbinden. · Dauer: ca. 90 min · Voraussetzung: Tag 0–15
Spielregeln
- Arbeite in
~/kro-lab/pruefungmit einer Kopie deiner NotesApp-RGD. - Jede Aufgabe hat Prüfbefehle. Erst wenn sie zeigen, was dort steht, ist die Aufgabe gelöst.
- Die Lösungen liegen in
~/kro-lab/code/loesung/pruefung/. Ausgangspunkt dort ist die RGD nach dem Wettkampf (wettkampf/loesung/notesapp-rgd.yaml).
mkdir -p ~/kro-lab/pruefung
cd ~/kro-lab/pruefung
cp ~/kro-lab/tag09/notesapp-rgd.yaml .Übung 1: Pause
Ein Team will seine NotesApp über Nacht anhalten, ohne sie zu
löschen. Baue ein Feld paused (Default false).
Ist es true, läuft kein Pod von notes-api mehr. Die
Datenbank und der Service bleiben stehen, und die Instanz meldet
trotzdem Ready.
Prüfe:
kubectl -n app patch notesapp notes --type merge -p '{"spec":{"paused":true}}'
kubectl -n app wait notesapp/notes --for=condition=Ready --timeout=60s
kubectl -n app get deploy notesErwartet:
notesapp.lab.example.com/notes patched
notesapp.lab.example.com/notes condition met
NAME READY UP-TO-DATE AVAILABLE AGE
notes 0/0 0 0 5h34m
Lösung
Im Schema:
paused: boolean | default=false
Im Deployment:
replicas: '${schema.spec.paused ? 0 : schema.spec.replicas}'
Die einfachen Anführungszeichen sind Pflicht, sonst stolperst du über
den Doppelpunkt aus Tag 3. Die readyWhen-Bedingungen
bleiben unverändert: Bei null gewünschten und null verfügbaren Pods sind
beide wahr. Wieder einschalten:
kubectl -n app patch notesapp notes --type merge -p '{"spec":{"paused":false}}'
kubectl -n app wait notesapp/notes --for=condition=Ready --timeout=90s
curl -s localhost:30080/versionErwartet:
notesapp.lab.example.com/notes patched
notesapp.lab.example.com/notes condition met
0.5.1
Fortschritt speichern? Kostenlos registrieren
Übung 2: Speichergrenze
Jeder Container von notes-api soll eine Speichergrenze bekommen. Das
Team darf sie setzen, Default 64Mi, und nur in
Mi. Ein Wert wie 1Gi oder viel
soll der API-Server ablehnen.
Prüfe:
kubectl -n app get deploy notes \
-o jsonpath='{.spec.template.spec.containers[0].resources}{"\n"}'
kubectl -n app patch notesapp notes --type merge -p '{"spec":{"memory":"viel"}}'Erwartet:
{"limits":{"memory":"64Mi"}}
The NotesApp "notes" is invalid: spec.memory: Invalid value: "viel": spec.memory in
body should match '^[0-9]+Mi$'
Lösung
memory: string | default="64Mi" pattern="^[0-9]+Mi$"
Im Container api, vor der
readinessProbe:
resources:
limits:
memory: ${schema.spec.memory}
Der Typ passt: memory ist in Kubernetes eine
Mengenangabe, die auch als Text angenommen wird.
Fortschritt speichern? Kostenlos registrieren
Übung 3: Ist die Datenbank da?
Die Instanz soll im Status ein Feld dbReady (wahr oder
falsch) zeigen, das sagt, ob Postgres bereit ist.
Prüfe:
kubectl -n app get notesapp notes -o jsonpath='dbReady={.status.dbReady}{"\n"}'Erwartet:
dbReady=true
Lösung
dbReady: ${database.status.?readyReplicas.orValue(0) == 1}
kro leitet daraus den Typ boolean ab. Springt die
Instanz auf ERROR mit
schema not found for field dbReady, kennst du das Mittel:
kubectl -n kro-system rollout restart deploy/kro.
Fortschritt speichern? Kostenlos registrieren
Übung 4: Die Übersicht
Das Plattform-Team will wissen, welche NotesApps es im Cluster gibt.
Baue eine neue, cluster-weite API NotesOverview. Eine
Instanz zählt alle NotesApps in allen Namespaces, zeigt sie im Status
und schreibt die Liste in eine ConfigMap notes-overview im
Namespace platform. Kommt eine NotesApp dazu, aktualisiert
sich die Übersicht von selbst.
Prüfe:
kubectl get notesoverview alle -o jsonpath='{.status.total} | {.status.apps}{"\n"}'
kubectl -n platform get configmap notes-overview -o jsonpath='{.data.apps}{"\n"}'Erwartet:
2 | app/notes, blau-dev/notes
app/notes, blau-dev/notes
Hinweis: Eine externe Collection ohne
namespace sucht in allen Namespaces. Ein leerer Selector
{} passt auf alles. Denk an die Rechte (Tag 12).
Lösung
cat > overview-rgd.yaml <<'EOF'
apiVersion: kro.run/v1alpha1
kind: ResourceGraphDefinition
metadata:
name: notesoverview
spec:
schema:
apiVersion: v1alpha1
kind: NotesOverview
group: lab.example.com
scope: Cluster
spec:
target: string | default="platform"
status:
total: ${size(apps)}
apps: ${apps.map(a, a.metadata.namespace + "/" + a.metadata.name).join(", ")}
resources:
- id: apps
externalRef:
apiVersion: lab.example.com/v1alpha1
kind: NotesApp
metadata:
selector: {}
- id: summary
template:
apiVersion: v1
kind: ConfigMap
metadata:
name: notes-overview
namespace: ${schema.spec.target}
data:
apps: ${apps.map(a, a.metadata.namespace + "/" + a.metadata.name).join(", ")}
EOF
cat > overview-rbac.yaml <<'EOF'
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: kro:controller:overview
labels:
rbac.kro.run/aggregate-to-controller: "true"
rules:
- apiGroups: ["lab.example.com"]
resources: ["notesoverviews", "notesoverviews/status"]
verbs: ["*"]
EOF
cat > overview.yaml <<'EOF'
apiVersion: lab.example.com/v1alpha1
kind: NotesOverview
metadata:
name: alle
spec: {}
EOF
kubectl apply -f overview-rbac.yaml
kubectl apply -f overview-rgd.yaml
kubectl wait --for=condition=Ready rgd/notesoverview --timeout=90s
kubectl apply -f overview.yaml
kubectl wait notesoverview/alle --for=condition=Ready --timeout=60sErwartet:
clusterrole.rbac.authorization.k8s.io/kro:controller:overview created
resourcegraphdefinition.kro.run/notesoverview created
resourcegraphdefinition.kro.run/notesoverview condition met
notesoverview.lab.example.com/alle created
notesoverview.lab.example.com/alle condition met
scope: Cluster, deshalb braucht die ConfigMap einen ausdrücklichennamespace.- Lesen von
notesappsdarf kro schon seit Tag 12 (kro:controller:notes). Neu sind nur die Rechte fürnotesoverviews. - Eine RGD darf aus einer einzigen externen Referenz plus einem Objekt bestehen. Sie muss nicht wie eine Anwendung aussehen.
Lege zum Gegentest eine weitere Umgebung an (blau um
test erweitern). Die Zahl in der Übersicht steigt auf drei,
ohne dass du die Übersicht anfasst.
Fortschritt speichern? Kostenlos registrieren
Geschafft
Wenn alle vier Übungen ihre Prüfbefehle bestehen, hast du das Trainingslager hinter dir. Du kannst:
- eigene APIs für Kubernetes mit Schema, Defaults und Validierung bauen,
- Objekte über CEL verdrahten und kros Prüfmeldungen lesen,
- Readiness, Bedingungen, Collections und externe Referenzen einsetzen,
- APIs aus Bausteinen zusammensetzen,
- kro mit eingeschränkten Rechten betreiben, aktualisieren und überwachen,
- entscheiden, wann kro passt und wann Helm, Kustomize oder ein Operator.
Aufräumen, wenn du das Labor nicht mehr brauchst:
exit
multipass delete --purge kro