Tag 0: Das Trainingsgelände
Ziel: Eine Labor-VM mit k3s und Helm, der Begleitcode und notes-api einmal von Hand im Cluster, damit du siehst, was kro dir später abnimmt. · Dauer: ca. 45 min · Voraussetzung: keine
Briefing
- kro steht für Kube Resource Orchestrator. Es ist ein Controller, der im Cluster läuft. Du beschreibst ihm eine eigene API, und er erzeugt daraus eine CRD samt Controller, ohne dass du Code schreibst.
- Die Beschreibung heißt ResourceGraphDefinition
(RGD). Sie enthält ein Schema (welche Felder darf das
Team setzen?) und Ressourcen (welche Objekte entstehen
daraus?). Werte fließen über CEL-Ausdrücke der Form
${…}von einem Objekt zum nächsten. - Alles läuft in einem k3s auf deiner VM. Erreichbar ist notes-api über NodePorts, also feste Ports zwischen 30000 und 32767 auf der VM.
Laptop ──ssh──► VM kro
└─ k3s
├─ kro-system: kro (ab Tag 1)
├─ handarbeit: notes-api von Hand (heute)
└─ app: NotesApp-Instanzen (ab Tag 4)
curl ─► http://<VM-IP>:30080 notes-api
Drill 1: Die Labor-VM
Auf dem Laptop (Multipass von
multipass.run):
multipass launch 24.04 --name kro --cpus 2 --memory 4G --disk 30G
multipass exec kro -- bash -c "echo '$(cat ~/.ssh/id_ed25519.pub)' \
>> ~/.ssh/authorized_keys"
multipass info kro | grep IPv4
ssh ubuntu@<IP aus der Ausgabe>
- 4 GB reichen für kro, drei kleine Datenbanken und ein paar notes-api-Pods. Der kro-Controller selbst braucht rund 100 MB.
- Jede andere Linux-VM mit
sudound Internetzugang tut es auch.
Ab hier läuft alles in der VM.
Fortschritt speichern? Kostenlos registrieren
Drill 2: k3s
curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=v1.37.2+k3s1 \
sh -s - --disable traefik --disable servicelbErwartet (gekürzt):
[INFO] Using v1.37.2+k3s1 as release
...
[INFO] systemd: Enabling k3s unit
[INFO] systemd: Starting k3s
get.k3s.ioist das offizielle Installationsskript. Es lädt k3s, legt den Dienst an und verlinktkubectl.--disable traefik --disable servicelb: Einen Ingress-Controller und einen Load-Balancer brauchst du nicht, alles läuft über NodePorts.
Die Zugangsdaten gehören root. Du machst dir eine
Kopie:
mkdir -p ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown "$(id -u):$(id -g)" ~/.kube/config
chmod 600 ~/.kube/config
echo 'export KUBECONFIG=~/.kube/config' >> ~/.bashrc
export KUBECONFIG=~/.kube/config
kubectl get nodesErwartet:
NAME STATUS ROLES AGE VERSION
kro Ready control-plane 25s v1.37.2+k3s1
KUBECONFIG ist bei k3s Pflicht. Ohne die Variable liest
dessen kubectl immer /etc/rancher/k3s/k3s.yaml
und scheitert mit permission denied.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Helm
kro kommt als Helm-Chart:
mkdir -p ~/.local/bin ~/kro-lab
cd ~/kro-lab
curl -fsSLO https://get.helm.sh/helm-v4.3.1-linux-amd64.tar.gz
tar xzf helm-v4.3.1-linux-amd64.tar.gz
mv linux-amd64/helm ~/.local/bin/
rm -r linux-amd64 helm-v4.3.1-linux-amd64.tar.gz
helm version --shortErwartet:
v4.3.1+gc0d08d0
Ubuntu nimmt ~/.local/bin beim Anmelden in den
PATH auf, sobald der Ordner existiert. Findet die Shell
helm nicht, meldest du dich einmal ab und wieder an.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Der Begleitcode
git clone -q https://github.com/thomaszachmann/kro-zum-anfassen.git ~/kro-lab/code
ls ~/kro-lab/code ~/kro-lab/code/loesungErwartet:
/home/ubuntu/kro-lab/code:
LICENSE loesung README.md wettkampf
/home/ubuntu/kro-lab/code/loesung:
pruefung tag02 tag04 tag06 tag08 tag10 tag13
tag01 tag03 tag05 tag07 tag09 tag12 tag14
loesung/tagNNenthält die fertigen Dateien jedes Tags. Du schreibst sie selbst und vergleichst am Ende mitdiff.wettkampf/brauchst du erst an Tag 15.
Ein Image musst du nicht bauen. notes-api liegt fertig in der GitHub
Container Registry:
ghcr.io/thomaszachmann/notes-api:0.5.1.
Fortschritt speichern? Kostenlos registrieren
Drill 5: notes-api von Hand
Bevor kro ins Spiel kommt, bringst du notes-api so in den Cluster, wie man es ohne Hilfe tut: Befehl für Befehl.
kubectl create namespace handarbeit
kubectl -n handarbeit create deployment notes \
--image=ghcr.io/thomaszachmann/notes-api:0.5.1 --port=8080
kubectl -n handarbeit get podsErwartet (nach ein paar Sekunden):
NAME READY STATUS RESTARTS AGE
notes-5f548db6f6-7frk7 0/1 Error 1 (9s ago) 10s
Warum? Das Log sagt es:
kubectl -n handarbeit logs deploy/notesErwartet:
time=2026-11-11T18:16:33.664Z level=ERROR msg="start abgebrochen"
err="NOTES_API_KEY oder NOTES_API_KEY_FILE fehlt"
notes-api verlangt einen API-Key, und der gehört in ein Secret:
kubectl -n handarbeit create secret generic notes-api \
--from-literal=NOTES_API_KEY=lab-api-key-123
kubectl -n handarbeit set env deployment/notes --from=secret/notes-api
kubectl -n handarbeit rollout status deploy/notesErwartet (gekürzt):
secret/notes-api created
deployment.apps/notes env updated
...
deployment "notes" successfully rolled out
set env --from=secret/… macht aus jedem Schlüssel des
Secrets eine Umgebungsvariable. Deshalb heißt der Schlüssel hier genau
wie die Variable, NOTES_API_KEY.
Jetzt fehlt noch der Weg nach draußen:
kubectl -n handarbeit expose deployment notes --type=NodePort --port=80 \
--target-port=8080
kubectl -n handarbeit get svc notesErwartet (der Port weicht ab):
service/notes exposed
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
notes NodePort 10.43.43.73 <none> 80:32097/TCP 0s
curl -s localhost:32097/versionErwartet:
0.5.1
Drei Objekte, fünf Befehle und ein Fehlstart, und das ohne Datenbank, Readiness-Probe oder festen Port. Das soll ein Team nicht jedes Mal von Hand machen müssen. Ab Tag 4 legst du dasselbe mit einem einzigen Objekt an.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
kubectl get nodesErwartet: ein Node kro mit STATUS
Ready.
helm version --shortErwartet: v4.3.1+gc0d08d0.
kubectl -n handarbeit get deploy notesErwartet:
NAME READY UP-TO-DATE AVAILABLE AGE
notes 1/1 1 1 2m
Challenge
Lege über den NodePort eine Notiz mit dem Text „Hallo kro“ an und lies sie wieder aus.
Hinweis: POST /notes mit Header
X-API-Key und JSON {"text": "…"}.
Lösung
curl -s -H "X-API-Key: lab-api-key-123" -d '{"text":"Hallo kro"}' \
localhost:32097/notes
curl -s localhost:32097/notesErwartet (die ID weicht ab):
{"id":"bb895acb-2aa5-4d1d-bf2e-e61f3f5c6a43","text":"Hallo kro"}
[{"id":"bb895acb-2aa5-4d1d-bf2e-e61f3f5c6a43","text":"Hallo kro"}]
Mit -d schickt curl automatisch ein
POST. Ohne Datenbank speichert notes-api im Speicher, nach
einem Neustart des Pods ist die Notiz weg.
Den Namespace brauchst du nicht mehr:
kubectl delete namespace handarbeitFortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Wer schreibt das YAML? In vielen Firmen kopieren
Teams Manifeste aus einem Wiki und passen sie an. Nach einem Jahr gibt
es zwanzig Varianten derselben App. Eine eigene API wie
NotesApphält die Varianten an einer Stelle zusammen. - Plattform-APIs: Was du in diesem Buch baust, heißt in Platform-Engineering-Kreisen „golden path“ oder „paved road“. Die Plattform bietet einfache Bausteine an, und die Teams müssen die Details nicht kennen.
- NodePorts: Im Lab sind sie praktisch. Im Betrieb steht davor ein Ingress oder ein Gateway, siehe „Gateway API zum Anfassen“.