Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: Rancher Desktop

Ziel: Container mit nerdctl starten, die Images von notes so bauen, dass k3s sie ohne Registry findet, und notes mit dem Helm-Chart im eingebauten k3s laufen lassen. · Dauer: ca. 60 min · Voraussetzung: Tag 0

Briefing

  • containerd trennt Images und Container in Namespaces. nerdctl arbeitet im Namespace default, k3s im Namespace k8s.io.
  • Ein Image, das du mit nerdctl --namespace k8s.io build baust, sieht k3s sofort. Eine Registry brauchst du dafür nicht.
  • Das Chart von notes erwartet einen Plattform-Teil, den es nicht selbst anlegt: Namespace mit Pod Security, Quota und den ServiceAccount notes.
  • Den Weg von außen öffnet heute kubectl port-forward; an Tag 2 übernimmt Traefik.
 nerdctl ──► containerd ─┬─ Namespace default : nginx (Drill 1)
                         └─ Namespace k8s.io  : notes-api, notes-web, notes-worker
                                                      ▲
                                    k3s (Rancher Desktop) startet Pods daraus

Drill 1: Ein Container

source ~/rancher-lab/setup/env.sh
mkdir -p "$LAB/tag01" && cd "$LAB/tag01"
nerdctl run -d --name hallo -p 8080:80 nginx:1.30.6-alpine
nerdctl ps
curl -s localhost:8080 | grep -o '<title>.*</title>'
nerdctl rm -f hallo

Erwartet (gekürzt, IDs und Zeiten weichen bei dir ab):

39b48194831609272390bbc7e28314b12eee3682a99af508099c449aa24225b1
CONTAINER ID    IMAGE                                    …   PORTS
39b481948316    docker.io/library/nginx:1.30.6-alpine    …   0.0.0.0:8080->80/tcp
<title>Welcome to nginx!</title>
hallo

nerdctl hat dieselben Befehle wie docker. Rancher Desktop leitet den Port aus der VM an den Mac weiter, darum antwortet localhost:8080.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Namespaces in containerd

nerdctl namespace ls
nerdctl --namespace k8s.io images | head -3

Erwartet (gekürzt):

NAME                          CONTAINERS    IMAGES    VOLUMES    LABELS
buildkit                      0             0         0
default                       0             1         0
k8s.io                        15            19        0
rancher-desktop-extensions    0             1         0
REPOSITORY               TAG    IMAGE ID        CREATED     PLATFORM      SIZE
rancher/mirrored-pause   3.6    74c4244427b7    About a m…  linux/arm64   491.5kB
…

default hält dein nginx-Image, k8s.io die Images und Container von k3s. Die beiden sehen einander nicht: Ein Image in default findet Kubernetes nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 3: notes für k3s bauen

cd "$NOTES"
nerdctl --namespace k8s.io build -q --build-arg VERSION=0.2.0 \
  -t notes-api:0.2.0 notes-api
nerdctl --namespace k8s.io build -q --build-arg VERSION=0.1.0 \
  -t notes-web:0.1.0 notes-web
nerdctl --namespace k8s.io build -q --build-arg VERSION=0.1.0 \
  -t notes-worker:0.1.0 notes-worker
nerdctl --namespace k8s.io images | grep notes
cd "$LAB/tag01"

Erwartet (gekürzt, beim ersten Mal ein bis zwei Minuten):

…
notes-worker   0.1.0   7c42ba6117f5   1 second ago     linux/arm64   167.8MB   45.77MB
notes-web      0.1.0   fd98ab494eb0   22 seconds ago   linux/arm64   196.8MB   69.21MB
notes-api      0.2.0   7b228b421269   46 seconds ago   linux/arm64   11.28MB   4.089MB

Die Versionen passen zum Chart: api 0.2.0 (appVersion), web und worker 0.1.0. BuildKit läuft in der VM von Rancher Desktop und schreibt direkt nach k8s.io.

Tipp: Wird der Platz knapp: nerdctl --namespace k8s.io builder prune -f löscht den Build-Cache. Im Test machte er über 1 GB aus.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Das Chart ohne Plattform

Was passiert, wenn man das Chart einfach installiert? Der Versuch lohnt sich:

kubectl config use-context rancher-desktop
kubectl create namespace notes
kubectl -n notes create secret generic notes-api --from-literal=api-key=lab-api-key-123
kubectl -n notes create secret generic notes-db --from-literal=password=lab-db-pw-123 \
  --from-literal=db-url='postgres://notes:lab-db-pw-123@db:5432/notes'
helm -n notes install notes "$LAB/code/notes-chart/notes" \
  --set gateway.enabled=false --wait --timeout 2m
kubectl -n notes get pods
kubectl -n notes get events --field-selector reason=FailedCreate \
  -o custom-columns=MSG:.message | sort -u | head -2

Erwartet (gekürzt):

namespace/notes created
secret/notes-api created
secret/notes-db created
Error: INSTALLATION FAILED: resource Deployment/notes/api not ready. status: InProgress,
message: Replicas: 0/3
No resources found in notes namespace.
Create Pod db-0 in StatefulSet db failed error: pods "db-0" is forbidden: error looking
up service account notes/notes: serviceaccount "notes" not found
Error creating: pods "api-65dfff884-" is forbidden: error looking up service account …

Kein einziger Pod. Das Chart verwendet den ServiceAccount notes, legt ihn aber nicht an; er gehört zum Plattform-Teil („Kubernetes zum Anfassen”, Tag 10). Räum den Fehlversuch ab:

helm -n notes uninstall notes
kubectl delete namespace notes

Erwartet:

release "notes" uninstalled
namespace "notes" deleted

Fortschritt speichern? Kostenlos registrieren

Drill 5: Plattform zuerst, dann das Chart

kubectl apply -f "$LAB/code/platform/namespace.yaml"
kubectl -n notes create secret generic notes-api --from-literal=api-key=lab-api-key-123
kubectl -n notes create secret generic notes-db --from-literal=password=lab-db-pw-123 \
  --from-literal=db-url='postgres://notes:lab-db-pw-123@db:5432/notes'
helm -n notes install notes "$LAB/code/notes-chart/notes" \
  --set gateway.enabled=false --wait --timeout 5m | grep -E '^(NAME|STATUS):'
kubectl -n notes get pods

Erwartet (gekürzt, nach knapp zwei Minuten):

namespace/notes created
limitrange/defaults created
resourcequota/notes created
serviceaccount/notes created
secret/notes-api created
secret/notes-db created
NAME: notes
STATUS: deployed
NAME                      READY   STATUS      RESTARTS      AGE
api-65dfff884-4w7h8       1/1     Running     4 (63s ago)   105s
…
db-0                      1/1     Running     0             104s
migrate-q2s75             0/1     Completed   1 (4s ago)    6s
web-7fd8cd6fd9-fmxwj      1/1     Running     0             106s
…

Jetzt läuft alles. Die Images kommen aus k8s.io (Drill 3): Das Chart nennt notes-api, containerd ergänzt das zu docker.io/library/notes-api und findet es lokal. Die api startet ein paarmal neu, bis Postgres bereit ist.

Fortschritt speichern? Kostenlos registrieren

Drill 6: notes im Browser

kubectl -n notes port-forward svc/web 3000:3000 &
curl -s -X POST -H 'Content-Type: application/json' -d '{"text":"auf dem Laptop"}' \
  localhost:3000/api/notes; echo
curl -s localhost:3000/api/notes; echo
open http://localhost:3000

Erwartet (gekürzt):

Forwarding from 127.0.0.1:3000 -> 3000
{"id":"…","text":"auf dem Laptop"}
[{"id":"…","text":"auf dem Laptop"}]

port-forward baut einen Tunnel vom Mac zum Service web; die NetworkPolicies des Charts greifen dafür nicht. Beende den Tunnel mit kill %1 und stell den Kontext zurück:

kill %1
kubectl config use-context default

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

nerdctl --namespace k8s.io images | grep -c '^notes-'

Erwartet: drei Images von notes in k8s.io.

3
helm --kube-context rancher-desktop -n notes list

Erwartet: Release notes, deployed.

NAME    NAMESPACE   REVISION   UPDATED   STATUS     CHART         APP VERSION
notes   notes       1          2026-…    deployed   notes-0.3.0   0.2.0
kubectl --context rancher-desktop -n notes get serviceaccount notes

Erwartet: der ServiceAccount aus dem Plattform-Teil.

NAME    SECRETS   AGE
notes   0         5m

Challenge

An Tag 2 brauchst du die Images von notes auf einer VM ohne Registry. Pack alle drei in eine einzige Archivdatei und prüfe, wie groß sie ist.

Hinweis: nerdctl save nimmt mehrere Images auf einmal.

Lösung

nerdctl --namespace k8s.io save -o notes-images.tar \
  notes-api:0.2.0 notes-web:0.1.0 notes-worker:0.1.0
ls -lh notes-images.tar

Erwartet (gekürzt):

-rw-r--r--  1 …  …M … notes-images.tar

Das Archiv enthält die Schichten aller drei Images, gemeinsame Schichten nur einmal. Genau diese Datei kopierst du an Tag 2 auf die VM und importierst sie dort.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Dev-Umgebung: Rancher Desktop gibt Entwicklern lokal dasselbe Kubernetes wie später k3s oder RKE2. Unterschiede bleiben: ein Node, kein Longhorn, keine echten Netzwerkgrenzen.
  • Images: Lokal gebaute Images ohne Registry sind bequem, aber nicht nachvollziehbar. In der CI baut man, signiert und schiebt in eine Registry (Tag 7).
  • Ressourcen: Eine laufende Rancher-Desktop-VM belegt dauerhaft Speicher. rdctl shutdown beendet sie, wenn sie nicht gebraucht wird.
  • Plattform und Chart: Die Trennung aus Drill 4 gilt überall: Teams bekommen Namespaces mit Rechten und Quotas von der Plattform, Charts bringen nur die Anwendung.