Tag 7: Bedingungen mit includeWhen
Ziel: Optionale Objekte: Eine NetworkPolicy schützt Postgres auf Wunsch, ein PodDisruptionBudget entsteht von selbst, sobald es mehr als eine Replika gibt. · Dauer: ca. 40 min · Voraussetzung: Tag 6
Briefing
includeWhenist eine Liste von Bedingungen an einem Objekt. Nur wenn alletruesind, legt kro das Objekt an. Für ODER schreibst du||in eine Bedingung.- kro wertet die Bedingungen bei jedem Abgleich neu aus. Wird eine
false, räumt kro das Objekt ab. - Fällt ein Objekt weg, fallen alle Objekte, die davon abhängen, mit weg.
- Bedingungen auf
schema.specsind stabil. Bedingungen auf den Status anderer Objekte können hin- und herspringen und erzeugen dann ständig Objekte und löschen sie wieder („Flip-Flop“). Dafür istreadyWhendas bessere Werkzeug.
| Objekt | Bedingung |
|---|---|
dbPolicy (NetworkPolicy) |
${schema.spec.networkPolicy} |
budget (PodDisruptionBudget) |
${schema.spec.replicas > 1} |
Drill 1: Schalter im Schema
mkdir -p ~/kro-lab/tag07
cd ~/kro-lab/tag07
cp ../tag06/notesapp-rgd.yaml .Ergänze unter database: einen Schalter:
database:
storage: string | default="1Gi"
networkPolicy: boolean | default=false
Fortschritt speichern? Kostenlos registrieren
Drill 2: Zwei optionale Objekte
Hänge ans Ende der Datei (hinter das Objekt service)
an:
- id: dbPolicy
includeWhen:
- ${schema.spec.networkPolicy}
template:
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
name: ${database.metadata.name}
spec:
podSelector:
matchLabels: ${database.spec.selector.matchLabels}
policyTypes:
- Ingress
ingress:
- from:
- podSelector:
matchLabels: ${deployment.spec.selector.matchLabels}
ports:
- port: 5432
- id: budget
includeWhen:
- ${schema.spec.replicas > 1}
template:
apiVersion: policy/v1
kind: PodDisruptionBudget
metadata:
name: ${schema.metadata.name}
spec:
minAvailable: 1
selector:
matchLabels: ${deployment.spec.selector.matchLabels}
- Die NetworkPolicy gilt für die Postgres-Pods und lässt nur Pods von notes-api auf Port 5432 durch. Die Labels kommen aus den Selektoren, nicht als Text, und damit stimmen sie immer.
- Ein PodDisruptionBudget mit
minAvailable: 1bei nur einer Replika würde jedeskubectl drainblockieren. Deshalb entsteht es erst ab zwei Replikas.
kubectl apply -f notesapp-rgd.yaml
kubectl get rgd notesapp
kubectl get rgd notesapp -o jsonpath='{.status.topologicalOrder}{"\n"}'Erwartet:
resourcegraphdefinition.kro.run/notesapp configured
NAME APIVERSION KIND STATE READY AGE
notesapp v1alpha1 NotesApp Active True 18m
["secret","dbSecret","dbData","database","dbService","deployment","service",
"dbPolicy","budget"]
Beide neuen Objekte stehen in der Reihenfolge, angelegt hat kro aber noch keins:
kubectl -n app get networkpolicy,pdbErwartet:
No resources found in app namespace.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Offen
Ohne NetworkPolicy erreicht jeder Pod im Cluster die Datenbank. Ein
Test-Pod mit nc (Netcat) zeigt es:
kubectl -n app run probe --rm -i --restart=Never --image=busybox:1.38 \
-- nc -zv -w 2 notes-db 5432Erwartet (gekürzt):
notes-db (10.43.143.246:5432) open
pod "probe" deleted from app namespace
-zprüft nur, ob der Port antwortet, ohne Daten zu schicken.-w 2wartet höchstens zwei Sekunden.--rm -istartet den Pod, zeigt seine Ausgabe und löscht ihn danach.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Zu
Schalte die NetworkPolicy ein und gib der App zwei Replikas:
kubectl -n app patch notesapp notes --type merge \
-p '{"spec":{"networkPolicy":true,"replicas":2}}'
kubectl -n app get networkpolicy,pdbErwartet:
notesapp.lab.example.com/notes patched
NAME POD-SELECTOR AGE
networkpolicy.networking.k8s.io/notes-db app=notes-db 12s
NAME MIN AVAILABLE MAX UNAVAILABLE ALLOWED DISRUPTIONS AGE
poddisruptionbudget.policy/notes 1 N/A 1 12s
kubectl -n app run probe --rm -i --restart=Never --image=busybox:1.38 \
-- nc -zv -w 2 notes-db 5432Erwartet (gekürzt):
pod "probe" deleted from app namespace
pod app/probe terminated (Error)
Kein open mehr: Nach zwei Sekunden gibt nc
auf. k3s setzt NetworkPolicies mit seinem eingebauten Policy-Controller
durch. notes-api darf weiter:
curl -s localhost:30080/notesErwartet:
[{"id":"5953a797-216a-45be-a2f9-fe1e5782a1f4","text":"bleibt erhalten"}]
Fortschritt speichern? Kostenlos registrieren
Drill 5: Abräumen
kubectl -n app patch notesapp notes --type merge \
-p '{"spec":{"networkPolicy":false,"replicas":1}}'
kubectl -n app get networkpolicy,pdbErwartet:
notesapp.lab.example.com/notes patched
No resources found in app namespace.
Beide Bedingungen sind false, und kro hat beide Objekte
gelöscht. Das ApplySet aus Tag 1 sagt kro, welche Objekte es angelegt
hat. Was nicht mehr in den Graphen gehört, fliegt raus.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
kubectl get rgd notesappErwartet: STATE Active.
kubectl -n app patch notesapp notes --type merge -p '{"spec":{"networkPolicy":true}}'
kubectl -n app get networkpolicyErwartet:
notesapp.lab.example.com/notes patched
NAME POD-SELECTOR AGE
notes-db app=notes-db 3s
Die NetworkPolicy bleibt ab jetzt eingeschaltet.
diff notesapp-rgd.yaml ~/kro-lab/code/loesung/tag07/notesapp-rgd.yamlErwartet: keine Ausgabe.
Challenge
Die NetworkPolicy soll in Namespaces, deren Name mit
prod beginnt, immer gelten, egal was das
Team setzt. Wie lautet die Bedingung?
Hinweis: schema.metadata.namespace und
die String-Funktion startsWith.
Lösung
includeWhen:
- ${schema.spec.networkPolicy || schema.metadata.namespace.startsWith("prod")}
Eine Bedingung mit || statt zwei Einträgen, denn mehrere
Einträge sind UND verknüpft. Du musst das nicht anwenden, die Flotte an
Tag 10 benutzt den Schalter.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Sicher als Default: In einer echten Plattform wäre
networkPolicyper Defaulttrue, oder es gäbe gar keinen Schalter. Wer eine Ausnahme braucht, fragt nach. - Richtlinien gehören nicht nur in die RGD: Kyverno oder ValidatingAdmissionPolicies setzen Regeln für alle Objekte durch, auch für die, die nicht über kro entstehen. Siehe „Kyverno und NetworkPolicies zum Anfassen“.
- Vorsicht beim Abräumen: Fällt ein Objekt durch
includeWhenweg, löscht kro es wirklich. Bei Volumes oder Datenbanken gehört deshalb die Deletion Policy aus Tag 6 dazu.