Zum Inhalt springen
Trainingslager IT-Trainingslager

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/pruefung mit 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 notes

Erwartet:

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

Erwartet:

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=60s

Erwartet:

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ücklichen namespace.
  • Lesen von notesapps darf kro schon seit Tag 12 (kro:controller:notes). Neu sind nur die Rechte für notesoverviews.
  • 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