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 Namespacek8s.io. - Ein Image, das du mit
nerdctl --namespace k8s.io buildbaust, 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 halloErwartet (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 -3Erwartet (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 -flö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 -2Erwartet (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 notesErwartet:
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 podsErwartet (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:3000Erwartet (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 defaultFortschritt 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 listErwartet: 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 notesErwartet: 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.tarErwartet (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 shutdownbeendet 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.