Zum Inhalt springen
Trainingslager IT-Trainingslager

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 sudo und 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 servicelb

Erwartet (gekürzt):

[INFO]  Using v1.37.2+k3s1 as release
...
[INFO]  systemd: Enabling k3s unit
[INFO]  systemd: Starting k3s
  • get.k3s.io ist das offizielle Installationsskript. Es lädt k3s, legt den Dienst an und verlinkt kubectl.
  • --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 nodes

Erwartet:

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 --short

Erwartet:

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/loesung

Erwartet:

/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/tagNN enthält die fertigen Dateien jedes Tags. Du schreibst sie selbst und vergleichst am Ende mit diff.
  • 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 pods

Erwartet (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/notes

Erwartet:

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/notes

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

Erwartet (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/version

Erwartet:

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 nodes

Erwartet: ein Node kro mit STATUS Ready.

helm version --short

Erwartet: v4.3.1+gc0d08d0.

kubectl -n handarbeit get deploy notes

Erwartet:

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/notes

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

Fortschritt 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 NotesApp hä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“.