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 seineid. - 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-settingsErwartet:
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 nsetErwartet:
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-settingsErwartet: 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.yamlErwartet:
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-settingsErwartet: 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-settingsErwartet:
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 gruenErwartet:
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 gruenErwartet:
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-settingsErwartet: STATE Active, READY
True.
kubectl -n app get nsetErwartet:
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.yamlErwartet: 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 gruenFortschritt 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 applyder 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 mitorValueimmer 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.