Tag 1: kro installieren, erste RGD
Ziel: kro läuft im Cluster. Du hast eine erste eigene API
Greetinggebaut, eine Instanz angelegt und gesehen, wie kro die erzeugten Objekte bewacht. · Dauer: ca. 45 min · Voraussetzung: Tag 0
Briefing
- kro kommt als Helm-Chart aus
registry.k8s.io(dem Image-Speicher des Kubernetes-Projekts). kro ist ein Unterprojekt von Kubernetes SIG Cloud Provider. - Das Chart bringt drei CRDs mit:
ResourceGraphDefinition(kurzrgd),Graph(Alpha, Tag 14) undGraphRevision(kurzgr, Tag 11). - Legst du eine RGD an, macht kro vier Dinge: Es prüft sie, erzeugt eine CRD für deine neue Art, startet einen Controller dafür und legt die Objekte an, sobald jemand eine Instanz erstellt.
RGD greeting ──► CRD greetings.kro.run ──► Instanz Greeting/hallo
│ kro wendet an
▼
ConfigMap hallo
Drill 1: kro installieren
helm install kro oci://registry.k8s.io/kro/charts/kro \
--namespace kro-system --create-namespace --version 0.10.0Erwartet (gekürzt):
Pulled: registry.k8s.io/kro/charts/kro:0.10.0
Digest: sha256:56561368ed4c574520e8bd6a677a2e6c66333fb90e759ff4f2f068341fe9956c
NAME: kro
NAMESPACE: kro-system
STATUS: deployed
REVISION: 1
oci://: Das Chart liegt als OCI-Artefakt in einer Registry, einhelm repo addbraucht es nicht.--version 0.10.0pinnt die Version. Ohne sie nimmt Helm die neueste.
kubectl -n kro-system get podsErwartet:
NAME READY STATUS RESTARTS AGE
kro-69965dc9cc-cgc4f 1/1 Running 0 31s
Ein einziger Pod, das ist der ganze Controller.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Was kro mitbringt
kubectl get crd | grep kroErwartet:
graphrevisions.internal.kro.run 2026-11-11T17:28:00Z
graphs.kro.run 2026-11-11T17:28:00Z
resourcegraphdefinitions.kro.run 2026-11-11T17:28:00Z
kubectl api-resources --api-group=kro.runErwartet:
NAME SHORTNAMES APIVERSION NAMESPACED KIND
graphs kro.run/v1alpha1 true Graph
resourcegraphdefinitions rgd kro.run/v1alpha1 false ResourceGraphDefinition
Eine RGD ist cluster-weit
(NAMESPACED false). Sie definiert eine API für den ganzen
Cluster, so wie eine CRD.
Die Einstellungen des Charts zeigt dir Helm:
helm show values oci://registry.k8s.io/kro/charts/kro --version 0.10.0 \
| grep -A3 '^rbac:'Erwartet:
rbac:
# Specifies how to manage access for kro in the cluster
# Two modes are currently supported:
# - unrestricted: Grants cluster-wide full access to all resources
Der Standard ist unrestricted: kro darf
alles im Cluster. Fürs Lab ist das bequem. An Tag 12
stellst du auf aggregation um.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Die erste RGD
Du baust eine API Greeting. Jede Instanz bekommt eine
ConfigMap mit einer Nachricht.
mkdir -p ~/kro-lab/tag01
cd ~/kro-lab/tag01
cat > greeting-rgd.yaml <<'EOF'
apiVersion: kro.run/v1alpha1
kind: ResourceGraphDefinition
metadata:
name: greeting
spec:
schema:
apiVersion: v1alpha1
kind: Greeting
spec:
message: string
resources:
- id: config
template:
apiVersion: v1
kind: ConfigMap
metadata:
name: ${schema.metadata.name}
data:
message: ${schema.spec.message}
EOFschemabeschreibt die neue API: ArtGreeting, Versionv1alpha1, ein Feldmessagevom Typstring. Die Gruppe fehlt, also nimmt krokro.run.resourcesist die Liste der Objekte. Jedes hat eineid(hierconfig) und eintemplate, ein ganz normales Kubernetes-Manifest.${schema.metadata.name}ist ein CEL-Ausdruck. Er liest den Namen der Instanz.${schema.spec.message}liest das Feld, das das Team setzt.'EOF'in Anführungszeichen ist wichtig: So lässt die Shell die${…}in Ruhe.
kubectl apply -f greeting-rgd.yaml
kubectl get rgdErwartet:
resourcegraphdefinition.kro.run/greeting created
NAME APIVERSION KIND STATE READY AGE
greeting v1alpha1 Greeting Active True 6s
Active und True: kro hat die RGD geprüft
und angenommen. Was es daraus gemacht hat, zeigt
-o wide:
kubectl get rgd greeting -o wide
kubectl get crd greetings.kro.runErwartet:
NAME APIVERSION KIND STATE READY TOPOLOGICALORDER AGE
greeting v1alpha1 Greeting Active True ["config"] 6s
NAME SCOPE VERSIONS CREATED AT
greetings.kro.run Namespaced v1alpha1(storage) 2026-11-11T17:29:59Z
TOPOLOGICALORDERist die Reihenfolge, in der kro die Objekte anlegt. Bei einem einzigen Objekt ist sie langweilig, ab Tag 4 nicht mehr.- Die CRD
greetings.kro.runhat kro selbst erzeugt. Ab jetzt kennt der API-Server die ArtGreeting:
kubectl explain greeting.specErwartet:
GROUP: kro.run
KIND: Greeting
VERSION: v1alpha1
FIELD: spec <Object>
DESCRIPTION:
<empty>
FIELDS:
message <string>
<no description>
Fortschritt speichern? Kostenlos registrieren
Drill 4: Die erste Instanz
kubectl create namespace app
cat > hallo.yaml <<'EOF'
apiVersion: kro.run/v1alpha1
kind: Greeting
metadata:
name: hallo
namespace: app
spec:
message: Hallo kro
EOF
kubectl apply -f hallo.yaml
kubectl -n app get greetingErwartet:
namespace/app created
greeting.kro.run/hallo created
NAME STATE READY AGE
hallo ACTIVE True 4s
Für das Team sieht Greeting aus wie jede andere
Kubernetes-Art. Was dahinter entstanden ist:
kubectl -n app get configmap hallo -o yamlErwartet (gekürzt):
apiVersion: v1
data:
message: Hallo kro
kind: ConfigMap
metadata:
annotations:
internal.kro.run/apply-order: "1"
internal.kro.run/node-path: config
labels:
app.kubernetes.io/managed-by: kro
applyset.kubernetes.io/part-of: applyset-Iiz_0lx5c0WuukoyYjCPBF1CcU-I56PoX...
kro.run/instance-kind: Greeting
kro.run/instance-name: hallo
kro.run/instance-namespace: app
kro.run/kro-version: v0.10.0
kro.run/node-id: config
kro.run/owned: "true"
name: hallo
namespace: app
- Die Labels
kro.run/…sagen, zu welcher Instanz und zu welchem Knoten (node-id) das Objekt gehört. Damit findest du später alles, was zu einer Instanz gehört. applyset.kubernetes.io/part-of: kro führt über ein ApplySet Buch über alles, was es angelegt hat. Fällt ein Objekt aus der RGD heraus, weiß kro so, was es aufräumen muss.
Fortschritt speichern? Kostenlos registrieren
Drill 5: kro passt auf
Ändere die ConfigMap von Hand:
kubectl -n app patch configmap hallo --type merge -p '{"data":{"message":"von Hand"}}'
kubectl -n app get configmap hallo -o jsonpath='{.data.message}{"\n"}'Erwartet:
configmap/hallo patched
Hallo kro
Die Änderung war schon wieder weg, bevor du nachsehen konntest. kro beobachtet die Objekte, die es angelegt hat, und setzt jede Abweichung sofort zurück. Das nennt man Drift-Korrektur.
Lösche die ConfigMap:
kubectl -n app delete configmap hallo
kubectl -n app get configmap halloErwartet:
configmap "hallo" deleted from app namespace
NAME DATA AGE
hallo 1 5s
Sie ist sofort wieder da. Was die Instanz selbst über ihren Zustand sagt:
kubectl -n app get greeting hallo \
-o jsonpath='{range .status.conditions[*]}{.type}={.status}{"\n"}{end}'Erwartet:
InstanceManaged=True
GraphResolved=True
ResourcesReady=True
Ready=True
| Condition | Bedeutung |
|---|---|
InstanceManaged |
kro hat Finalizer und Labels gesetzt |
GraphResolved |
Alle Ausdrücke ließen sich auswerten |
ResourcesReady |
Alle Objekte sind angelegt und bereit |
Ready |
Alle drei oben sind True |
Fortschritt speichern? Kostenlos registrieren
Drill 6: Was der Controller sagt
kubectl -n kro-system logs deploy/kro | grep greetingErwartet (gekürzt):
... INFO rgd-controller Creating CRD {"controller": "ResourceGraphDefinition",
..., "name": "greeting", ..., "name": "greetings.kro.run"}
... INFO rgd-controller Waiting for CRD to become ready {..., "name": "greeting",
...}
Die Logs sind deine erste Anlaufstelle, wenn eine RGD nicht
Active wird.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
kubectl get rgd greetingErwartet: STATE Active, READY
True.
kubectl -n app get greeting halloErwartet: STATE ACTIVE, READY
True.
kubectl -n app get configmap -l kro.run/instance-name=halloErwartet:
NAME DATA AGE
hallo 1 3m
Das Label findet alle Objekte einer Instanz, egal welcher Art.
Challenge
Ändere die Nachricht der Instanz hallo auf „Servus kro“,
ohne die ConfigMap anzufassen. Prüfe danach die ConfigMap und lösche zum
Schluss die Instanz. Was passiert mit der ConfigMap?
Hinweis: Die Instanz ist ein Objekt wie jedes
andere, kubectl patch oder kubectl edit
funktionieren.
Lösung
kubectl -n app patch greeting hallo --type merge -p '{"spec":{"message":"Servus kro"}}'
kubectl -n app get configmap hallo -o jsonpath='{.data.message}{"\n"}'
kubectl -n app delete greeting hallo
kubectl -n app get configmap halloErwartet:
greeting.kro.run/hallo patched
Servus kro
greeting.kro.run "hallo" deleted from app namespace
Error from server (NotFound): configmaps "hallo" not found
Mit der Instanz löscht kro alles, was es für sie angelegt hat. Den
Finalizer kro.run/finalizer auf der Instanz entfernt es
erst, wenn die ConfigMap weg ist.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Version pinnen: kro ist noch vor 1.0, die API heißt
v1alpha1. Pinne die Chart-Version und lies vor jedem Upgrade die Upgrade-Hinweise (Tag 14). - Ein Controller pro Cluster: kro läuft als ein Deployment mit Leader Election. Mehr Replikas machen kro nicht schneller, sie sorgen nur für einen schnellen Wechsel, wenn ein Pod ausfällt.
unrestrictedist fürs Lab: In diesem Modus darf kro alles, und wer eine RGD anlegen darf, kann damit jedes Objekt im Cluster erzeugen. Tag 12 zeigt den Weg heraus.