Zum Inhalt springen
Trainingslager IT-Trainingslager

Anhang A: Spickzettel

Alles auf einen Blick, sortiert nach Thema.

Adressen im Lab

Was Wo
notes (Namespace app) http://<VM-IP>:30080
Flotte blau, Umgebung dev http://<VM-IP>:31100
Metriken von kro kubectl -n kro-system port-forward deploy/kro 8078:8078
Plattform-ConfigMap kubectl -n platform get configmap notes-platform
Werte für das Chart ~/kro-lab/kro-values.yaml

Installation und Upgrade

helm install kro oci://registry.k8s.io/kro/charts/kro \
  --namespace kro-system --create-namespace --version 0.10.0
helm upgrade kro oci://registry.k8s.io/kro/charts/kro -n kro-system \
  --version 0.10.0 -f ~/kro-lab/kro-values.yaml
U=https://raw.githubusercontent.com/kubernetes-sigs/kro/v0.10.0/helm/crds
kubectl apply --server-side -f $U/kro.run_resourcegraphdefinitions.yaml
kubectl -n kro-system rollout restart deploy/kro

Aufbau einer RGD

apiVersion: kro.run/v1alpha1
kind: ResourceGraphDefinition
metadata:
  name: <name>
spec:
  schema:
    apiVersion: v1alpha1
    kind: <Art>
    group: <gruppe>            # Standard: kro.run
    scope: Namespaced          # oder Cluster
    shortNames: [...]
    types: {...}               # eigene Typen
    spec: {...}                # SimpleSchema
    status: {...}              # CEL, Typ wird abgeleitet
    additionalPrinterColumns: [...]
  resources:
    - id: <lowerCamelCase>
      template: {...}          # oder externalRef: {...}
      includeWhen: [...]       # alle true → anlegen
      readyWhen: [...]         # alle true → bereit
      forEach: [...]           # Collection

SimpleSchema

Schreibweise Bedeutung
name: string Text
n: integer \| default=1 minimum=1 maximum=5 Zahl mit Default und Grenzen
on: boolean \| default=false Schalter
level: string \| enum="a,b" feste Auswahl
team: string \| required=true pattern="^[a-z]+$" Pflicht mit Muster
id: string \| immutable=true nach dem Anlegen fest
tags: "[]string \| uniqueItems=true maxItems=3" Liste
labels: "map[string]string" Map
owner: Contact eigener Typ aus types

CEL

Ausdruck Zweck
${schema.spec.x}, ${schema.metadata.name} Felder der Instanz
${deployment.status.readyReplicas} Feld eines anderen Objekts (Kante)
${string(n)} Zahl als Text
'${a ? "x" : "y"}' Verzweigung, in einfachen Anführungszeichen
${x.?feld.orValue(0)} Feld oder Ersatz
${liste.join(",")}, ${size(liste)} Listen
${liste.map(e, e.metadata.name)} Liste umformen
${lists.range(3)} [0, 1, 2]
${random.seededString(24, seed)} fester Zufallswert
${"${HOME}"} wörtliches ${HOME}
${runtime.newCondition({type, status, reason, message})} eigene Condition
${runtime.condition(schema, 'ResourcesReady')} kros eigene Condition

Prüfen und Fehler finden

kubectl get rgd
kubectl get rgd <name> -o wide
kubectl get rgd <name> \
  -o jsonpath='{range .status.conditions[*]}{.type}={.status} {.message}{"\n"}{end}'
kubectl get gr -l kro.run/resource-graph-definition-name=<name>
kubectl -n <ns> get <art> <instanz> \
  -o jsonpath='{range .status.conditions[*]}{.type}={.status} {.message}{"\n"}{end}'
kubectl -n <ns> get all -l kro.run/instance-name=<instanz>
kubectl -n kro-system logs deploy/kro --since=5m | grep ERROR
kubectl wait --for=condition=Ready rgd/<name> --timeout=60s

Meldungen und was sie bedeuten

Meldung Ursache Tag
mapping values are not allowed in this context : in einem Ausdruck ohne Anführungszeichen 3
type mismatch … returns type "int" but expected "string" string() fehlt 3
undefined field '…' Tippfehler im Feldnamen 3
references unknown identifiers: [HOME] ${…} ist kein Ausdruck, maskieren 3
graph contains a cycle zwei Objekte zeigen aufeinander 4
no such key: … (data pending) Feld ohne Default nicht gesetzt, ? nutzen 3
readyWhen … is false: waiting for readiness Objekt noch nicht bereit 5
schema not found for field … (Instanz ERROR) neues Status-Feld, kro neu starten 6
requires the DeletionPolicy feature gate Feature Gate fehlt 6
external ref … not found externes Objekt fehlt 9
breaking changes detected Schema-Änderung gesperrt 11
is forbidden: User "system:serviceaccount:kro-system:kro" Rechte im Modus aggregation 12
cache sync timeout (ControllerReady) Rechte für die neue Art fehlen 15
duplicate identity in collection zwei Elemente, ein Name 15

Feature Gates

Gate Wofür
DeletionPolicy Annotation kro.run/deletion-policy: Orphaned
InstanceConditionEvents Event bei jedem Wechsel einer Condition
InstanceConditionMetrics Metrik pro Instanz und Condition
CELOmitFunction omit() lässt ein Feld weg
ConservativeCRDComparison strengere Prüfung auf Breaking Changes
GraphKind die Graph-API

Reihenfolgen

  • Anlegen: RGD, kubectl wait --for=condition=Ready rgd/…, Rechte, Instanzen
  • Löschen: Instanzen, RGD, CRD
  • Volume schützen: Policy setzen, warten, bis die Annotation am Objekt steht, dann löschen
  • Schema verschärfen: erst die Instanzen umstellen, dann das Schema