Zum Inhalt springen
Trainingslager IT-Trainingslager

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

  • includeWhen ist eine Liste von Bedingungen an einem Objekt. Nur wenn alle true sind, 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.spec sind 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 ist readyWhen das 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: 1 bei nur einer Replika würde jedes kubectl drain blockieren. 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,pdb

Erwartet:

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 5432

Erwartet (gekürzt):

notes-db (10.43.143.246:5432) open
pod "probe" deleted from app namespace
  • -z prüft nur, ob der Port antwortet, ohne Daten zu schicken. -w 2 wartet höchstens zwei Sekunden.
  • --rm -i startet 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,pdb

Erwartet:

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 5432

Erwartet (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/notes

Erwartet:

[{"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,pdb

Erwartet:

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 notesapp

Erwartet: STATE Active.

kubectl -n app patch notesapp notes --type merge -p '{"spec":{"networkPolicy":true}}'
kubectl -n app get networkpolicy

Erwartet:

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

Erwartet: 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 networkPolicy per Default true, 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 includeWhen weg, löscht kro es wirklich. Bei Volumes oder Datenbanken gehört deshalb die Deletion Policy aus Tag 6 dazu.