Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: kro installieren, erste RGD

Ziel: kro läuft im Cluster. Du hast eine erste eigene API Greeting gebaut, 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 (kurz rgd), Graph (Alpha, Tag 14) und GraphRevision (kurz gr, 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.0

Erwartet (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, ein helm repo add braucht es nicht.
  • --version 0.10.0 pinnt die Version. Ohne sie nimmt Helm die neueste.
kubectl -n kro-system get pods

Erwartet:

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 kro

Erwartet:

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

Erwartet:

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}
EOF
  • schema beschreibt die neue API: Art Greeting, Version v1alpha1, ein Feld message vom Typ string. Die Gruppe fehlt, also nimmt kro kro.run.
  • resources ist die Liste der Objekte. Jedes hat eine id (hier config) und ein template, 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 rgd

Erwartet:

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

Erwartet:

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
  • TOPOLOGICALORDER ist die Reihenfolge, in der kro die Objekte anlegt. Bei einem einzigen Objekt ist sie langweilig, ab Tag 4 nicht mehr.
  • Die CRD greetings.kro.run hat kro selbst erzeugt. Ab jetzt kennt der API-Server die Art Greeting:
kubectl explain greeting.spec

Erwartet:

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 greeting

Erwartet:

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 yaml

Erwartet (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 hallo

Erwartet:

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 greeting

Erwartet (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 greeting

Erwartet: STATE Active, READY True.

kubectl -n app get greeting hallo

Erwartet: STATE ACTIVE, READY True.

kubectl -n app get configmap -l kro.run/instance-name=hallo

Erwartet:

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 hallo

Erwartet:

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.
  • unrestricted ist 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.