Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 3: CEL-Ausdrücke

Ziel: Werte umrechnen, verketten, verzweigen und fehlende Felder abfangen. Du lernst die Fehlermeldungen der statischen Prüfung lesen, bevor ein Team sie zu sehen bekommt. · Dauer: ca. 60 min · Voraussetzung: Tag 2

Briefing

  • Alles zwischen ${ und } ist CEL (Common Expression Language), dieselbe Sprache, die Kubernetes für Validierungsregeln nutzt. CEL ist typsicher, hat keine Schleifen und endet garantiert.
  • Lesbar sind schema.spec (Felder der Instanz), schema.metadata (Name, Namespace, Labels) und jedes andere Objekt der RGD über seine id.
  • kro prüft beim Anlegen der RGD jeden Ausdruck gegen das echte Schema der Zielart (statische Analyse): Gibt es das Feld? Passt der Typ? Ist die Syntax gültig?
  • Fällt die Prüfung durch, wird die RGD Inactive. Bestehende Instanzen laufen mit der letzten gültigen Fassung weiter.
Ausdruck Ergebnis
${string(schema.spec.maxNotes)} Zahl als Text
${a ? "x" : "y"} Verzweigung
${schema.spec.?tags.orValue([])} Feld oder Ersatzwert, wenn es fehlt
${liste.join(",")} Liste als Text
"${a} in ${b}" Mehrere Ausdrücke in einem Text

Drill 1: Ein Typfehler

mkdir -p ~/kro-lab/tag03
cd ~/kro-lab/tag03
cp ../tag02/settings-rgd.yaml .

Öffne settings-rgd.yaml im Editor (nano settings-rgd.yaml) und ergänze im data:-Block am Ende eine Zeile:

        data:
          team: ${schema.spec.team}
          logLevel: ${schema.spec.logLevel}
          maxNotes: ${schema.spec.maxNotes}
kubectl apply -f settings-rgd.yaml
kubectl get rgd notes-settings

Erwartet:

resourcegraphdefinition.kro.run/notes-settings configured
NAME             APIVERSION   KIND            STATE      READY   AGE
notes-settings   v1alpha1     NotesSettings   Inactive   False   38s

Den Grund nennt die Condition GraphAccepted:

kubectl get rgd notes-settings \
  -o jsonpath='{.status.conditions[?(@.type=="GraphAccepted")].message}{"\n"}'

Erwartet:

failed to validate resource "config": type mismatch in resource "config" at path
"data.maxNotes": expression "schema.spec.maxNotes" returns type "int" but expected
"string": type kind mismatch: got "int", expected "string"

Werte in einer ConfigMap sind immer Text, maxNotes ist eine Zahl. kro hat das erkannt, ohne dass eine einzige Instanz etwas davon gemerkt hat:

kubectl -n app get nset

Erwartet:

NAME   TEAM        LOG     STATE
blau   team-blau   debug   ACTIVE

Korrigiere die Zeile im Editor:

          maxNotes: ${string(schema.spec.maxNotes)}
kubectl apply -f settings-rgd.yaml
kubectl get rgd notes-settings

Erwartet: STATE Active, READY True.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Verzweigen, und der Doppelpunkt

readOnly soll als Wort in der ConfigMap stehen. Ergänze:

          mode: ${schema.spec.readOnly ? "lesen" : "lesen+schreiben"}
kubectl apply -f settings-rgd.yaml

Erwartet:

error: error parsing settings-rgd.yaml: error converting YAML to JSON: yaml: line 46:
mapping values are not allowed in this context

Das ist kein kro-Fehler, sondern YAML: Ein Doppelpunkt mit Leerzeichen dahinter beginnt einen neuen Schlüssel. Ausdrücke mit : gehören in einfache Anführungszeichen:

          mode: '${schema.spec.readOnly ? "lesen" : "lesen+schreiben"}'
kubectl apply -f settings-rgd.yaml
kubectl get rgd notes-settings

Erwartet: STATE Active.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Fehlende Felder

tags ist kein Pflichtfeld und hat keinen Default. Ergänze:

          tags: ${schema.spec.tags.join(",")}
kubectl apply -f settings-rgd.yaml
kubectl get rgd notes-settings

Erwartet:

NAME             APIVERSION   KIND            STATE    READY   AGE
notes-settings   v1alpha1     NotesSettings   Active   True    4m

Die statische Prüfung ist zufrieden, denn den Typ kennt sie. Ob das Feld in einer Instanz gesetzt ist, weiß sie nicht. Lege eine Instanz ohne tags an:

cat > gruen.yaml <<'EOF'
apiVersion: lab.example.com/v1alpha1
kind: NotesSettings
metadata:
  name: gruen
  namespace: app
spec:
  team: team-gruen
EOF
kubectl apply -f gruen.yaml
kubectl -n app get nset gruen

Erwartet:

notessettings.lab.example.com/gruen created
NAME    TEAM         LOG    STATE
gruen   team-gruen   info   IN_PROGRESS
kubectl -n app get nset gruen \
  -o jsonpath='{.status.conditions[?(@.type=="ResourcesReady")].message}{"\n"}'

Erwartet:

waiting for unresolved resource: apply "config": resolve: node "config": eval
"schema.spec.tags.join(\",\")" at "data.tags": eval "schema.spec.tags.join(\",\")":
no such key: tags (data pending) (executor: node not ready)

kro wartet darauf, dass tags auftaucht, und das passiert nie. Ein Feld ohne Default liest du deshalb mit dem Optional-Operator ? und gibst mit orValue einen Ersatzwert an:

          tags: ${schema.spec.?tags.orValue([]).join(",")}
kubectl apply -f settings-rgd.yaml
kubectl -n app get nset gruen

Erwartet:

NAME    TEAM         LOG    STATE
gruen   team-gruen   info   ACTIVE

Dasselbe Muster gilt für verschachtelte Felder. Ergänze:

          owner: ${schema.spec.?owner.?email.orValue("niemand")}

Fortschritt speichern? Kostenlos registrieren

Drill 4: Texte zusammensetzen

Mehrere Ausdrücke in einem Wert setzt kro zu einem Text zusammen, solange jeder einzelne Ausdruck einen Text liefert. Ergänze:

          summary: "${schema.spec.team} in ${schema.metadata.namespace}"
          hint: "Platzhalter wie ${HOME} bleiben stehen"
kubectl apply -f settings-rgd.yaml
kubectl get rgd notes-settings \
  -o jsonpath='{.status.conditions[?(@.type=="GraphAccepted")].message}{"\n"}'

Erwartet:

failed to build dependency graph: failed to extract dependencies: references unknown
identifiers: [HOME]

kro hält ${HOME} für einen Ausdruck und sucht ein Objekt mit der id HOME. Für ein wörtliches ${…}, etwa in einem Shell-Befehl, packst du den Text in einen CEL-String:

          hint: 'Platzhalter wie ${"${HOME}"} bleiben stehen'

Der äußere Ausdruck liefert den String ${HOME}, und der bleibt stehen.

kubectl apply -f settings-rgd.yaml
kubectl get rgd notes-settings
kubectl -n app get configmap blau-settings -o yaml | grep -A9 '^data:'

Erwartet:

NAME             APIVERSION   KIND            STATE    READY   AGE
notes-settings   v1alpha1     NotesSettings   Active   True    5m
data:
  hint: Platzhalter wie ${HOME} bleiben stehen
  logLevel: debug
  maxNotes: "100"
  mode: lesen+schreiben
  owner: [email protected]
  summary: team-blau in app
  tags: ""
  team: team-blau
kind: ConfigMap

Fortschritt speichern? Kostenlos registrieren

Drill 5: Drei typische Fehler

Du provozierst die drei häufigsten Meldungen der statischen Prüfung. Ändere jeweils eine Zeile, wende an, lies die Meldung und mach die Änderung wieder rückgängig.

Tippfehler im Feldnamen: team: ${schema.spec.teem}

failed to validate resource "config": failed to compile template expression
"schema.spec.teem" at path "data.team": ERROR: <input>:1:12: undefined field 'teem'
 | schema.spec.teem
 | ...........^

Unbekannte API-Version: apiVersion: v2 statt v1 bei der ConfigMap

failed to build resource "config": failed to get schema for resource config: cannot
resolve group version "v2": schema not found

Kreis: Zeigen zwei Objekte gegenseitig aufeinander, meldet kro (das siehst du an Tag 4):

failed to build dependency graph: graph contains a cycle: service -> deployment ->
service

Den Wortlaut liest du jeweils mit dem jsonpath-Befehl aus Drill 1.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

kubectl get rgd notes-settings

Erwartet: STATE Active, READY True.

kubectl -n app get nset

Erwartet:

NAME    TEAM         LOG     STATE
blau    team-blau    debug   ACTIVE
gruen   team-gruen   info    ACTIVE
diff settings-rgd.yaml ~/kro-lab/code/loesung/tag03/settings-rgd.yaml

Erwartet: keine Ausgabe.

Challenge

Setze bei blau die Tags intern und beta und schalte readOnly ein. Was steht danach in tags und mode der ConfigMap?

Hinweis: Ein merge-Patch mit zwei Feldern.

Lösung

kubectl -n app patch nset blau --type merge \
  -p '{"spec":{"tags":["intern","beta"],"readOnly":true}}'
kubectl -n app get configmap blau-settings -o jsonpath='{.data.tags} | {.data.mode}{"\n"}'

Erwartet:

notessettings.lab.example.com/blau patched
intern,beta | lesen

Aufräumen:

kubectl -n app delete nset gruen

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Fehler früh: Die statische Analyse ist der größte Vorteil von kro gegenüber Text-Templates. Ein Tippfehler fällt beim kubectl apply der RGD auf und nicht erst, wenn das zwanzigste Team ausrollt.
  • Optional bewusst einsetzen: ? schaltet die Prüfung für dieses Feld ab. Nutze es für Felder, die fehlen dürfen, und gib mit orValue immer einen sinnvollen Ersatz.
  • CEL-Bibliotheken: kro bringt Funktionen für Hashes, JSON, Zufallswerte, URLs, Regex, Mengenangaben und Semver mit. Die Liste steht unter „CEL Libraries“ auf kro.run. Einige davon nutzt du ab Tag 6.