Tag 0: Das Trainingsgelände
Ziel: Rancher Desktop auf dem Mac einrichten, die mitgelieferten Werkzeuge kennen, den Begleitcode holen und das eingebaute k3s einmal ansehen. · Dauer: ca. 45 min · Voraussetzung: keine
Briefing
- Rancher Desktop bringt Container und Kubernetes auf
den Laptop: eine kleine Linux-VM mit containerd und k3s, dazu
nerdctl,docker,kubectlundhelm. - In diesem Buch läuft Rancher Desktop mit containerd
als Laufzeit.
nerdctlspricht containerd so, wiedockerDocker spricht. - Ab Tag 2 kommen VMs dazu, die du per Multipass startest: k3s, Rancher selbst und das Cluster werk.
- Alle Dateien liegen unter
~/rancher-lab, der Begleitcode in~/rancher-lab/code.
Mac
┌──────────────────────────────────────────────────────────────┐
│ ~/rancher-lab/ setup/ code/ notes/ kube/ tagNN/ │
│ ~/.rd/bin: nerdctl, docker, kubectl, helm, rdctl │
│ Rancher Desktop VM (Alpine): containerd ─┬─ Namespace default │
│ └─ Namespace k8s.io ─► k3s v1.36.5
└──────────────────────────────────────────────────────────────┘
Drill 1: Platz und Speicher
Rancher Desktop legt eine VM an, die mit jedem Image wächst. Im Test belegte sie nach den Images von notes und Postgres gut 5 GB. Prüfe vorher:
df -h ~ | tail -1
sysctl -n hw.memsize | awk '{print $1/1073741824 " GB RAM"}'Erwartet (gekürzt, Werte weichen bei dir ab):
/dev/disk3s5 228Gi … … …
16 GB RAM
Achtung: Unter 20 GB freiem Platz brich hier ab und räume erst auf. Läuft die Platte voll, hilft nur
rdctl factory-reset, das die VM samt Images löscht.
Läuft Colima aus den Schwesterbüchern, stoppe es mit
colima stop. Zwei VMs mit Docker und Kubernetes vertragen
sich auf 16 GB schlecht.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Rancher Desktop installieren und starten
brew install --cask rancher
RD="/Applications/Rancher Desktop.app/Contents/Resources/resources/darwin/bin"
"$RD/rdctl" versionErwartet (gekürzt):
🍺 rancher was successfully installed!
rdctl client version: v1.24.0, targeting server version: v1
Beim ersten Start fragt Rancher Desktop im Fenster nach Laufzeit,
Kubernetes-Version und ob es deinen PATH ändern darf.
rdctl start setzt alles auf einmal, ohne Fenster und ohne
Änderungen an deinen Shell-Dateien:
"$RD/rdctl" start --application.admin-access=false \
--application.path-management-strategy=manual \
--application.start-in-background \
--container-engine.name=containerd \
--kubernetes.enabled=true --kubernetes.version=1.36.5 \
--virtual-machine.memory-in-gb=6 --virtual-machine.number-cpus=4 \
--virtual-machine.type=vz --no-modal-dialogsErwartet (gekürzt):
time="…" level=info msg="About to launch /usr/bin/open -a /Applications/Rancher Deskt…
Die VM bekommt 4 CPUs und 6 GB RAM, vz ist Apples eigene
Virtualisierung. path-management-strategy=manual heißt: Den
Pfad zu den Werkzeugen setzt du selbst.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Warten, bis alles läuft
until "$RD/rdctl" api /v1/backend_state 2>/dev/null | grep -q '"vmState":"STARTED"'; do
sleep 5
done
"$RD/rdctl" api /v1/backend_state; echo
export PATH="$HOME/.rd/bin:$PATH"
which nerdctl kubectl helm rdctlErwartet (gekürzt, nach etwa einer Minute):
{"vmState":"STARTED","locked":false}
/Users/…/.rd/bin/nerdctl
/Users/…/.rd/bin/kubectl
/Users/…/.rd/bin/helm
/Users/…/.rd/bin/rdctl
Ab jetzt liegen alle Werkzeuge in ~/.rd/bin. Den Pfad
setzt künftig setup/env.sh aus dem Begleitcode (Drill 6),
sobald du es mit source einliest.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Was Rancher Desktop mitbringt
nerdctl version | grep -E 'Version|OS/Arch'
kubectl version --client | head -1
helm version --short
kubectl config get-contextsErwartet (gekürzt):
Version: v2.2.2
OS/Arch: linux/arm64
Version: v0.28.1
Version: v2.3.2
Client Version: v1.37.2
v4.2.3+g43e8b7f
CURRENT NAME CLUSTER AUTHINFO NAMESPACE
* default default default
rancher-desktop rancher-desktop rancher-desktop
nerdctl 2.2, BuildKit 0.28, containerd 2.3, alles für arm64. Rancher
Desktop bringt ein eigenes Helm 4.2 mit; das Buch nutzt Helm 4.3 aus
Homebrew für die VMs, beide verstehen dieselben Befehle. Neu ist der
Kontext rancher-desktop. Der aktuelle Kontext bleibt, was
er war; Rancher Desktop drängt sich nicht vor.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Das eingebaute k3s
kubectl --context rancher-desktop get nodes -o wide
kubectl --context rancher-desktop get pods -n kube-systemErwartet (gekürzt):
NAME STATUS ROLES AGE VERSION … OS-IMAGE
lima-rancher-desktop Ready control-plane 5s v1.36.5+k3s1 … Alpine Lin…
NAME READY STATUS RESTARTS AGE
coredns-7cfb7bc9c7-2j8rl 1/1 Running 0 20s
helm-install-traefik-77mgk 0/1 Completed 1 (16s ago) 20s
helm-install-traefik-crd-8bgtf 0/1 Completed 0 20s
local-path-provisioner-77b9867795-q2wrd 1/1 Running 0 20s
metrics-server-6dc596dfb8-2mhs7 1/1 Running 0 20s
svclb-traefik-2da029cb-wspbr 2/2 Running 0 14s
traefik-7c8544f77-f55w7 1/1 Running 0 14s
Ein Node, k3s v1.36.5 auf Alpine Linux, mit Traefik, ServiceLB, local-path und metrics-server. Genau dieses k3s installierst du an Tag 2 auf einer VM von Hand.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Begleitcode und Arbeitsverzeichnis
Der Begleitcode liegt öffentlich auf GitHub:
mkdir -p ~/rancher-lab && cd ~/rancher-lab
git clone https://github.com/thomaszachmann/rancher-zum-anfassen.git code
mkdir -p setup kube
cp code/setup/env.sh setup/
cp -R code/notes notes
ls codeErwartet (gekürzt):
Cloning into 'code'...
README.md anhb notes notes-chart platform setup tag02 tag04 tag05 …
notes ist die Anwendung aus den Docker- und
Kubernetes-Büchern, notes-chart ihr Helm-Chart 0.3.0 aus
„Kubernetes zum Anfassen”, platform/namespace.yaml der
Teil, den das Chart nicht selbst anlegt.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
rdctl api /v1/backend_state; echoErwartet: die VM läuft.
{"vmState":"STARTED","locked":false}
kubectl --context rancher-desktop get nodesErwartet: ein Node, Ready, k3s v1.36.5.
NAME STATUS ROLES AGE VERSION
lima-rancher-desktop Ready control-plane 2m v1.36.5+k3s1
ls ~/rancher-lab/code/notesErwartet: die drei Teile von notes.
README.md notes-api notes-web notes-worker
Challenge
Rancher Desktop hat seine Einstellungen gespeichert. Lies mit
rdctl aus, mit welcher Laufzeit, welcher Kubernetes-Version
und wie viel Speicher es läuft.
Hinweis: rdctl list-settings gibt JSON
aus.
Lösung
rdctl list-settings | jq -c '{engine: .containerEngine.name,
k8s: .kubernetes.version, vm: .virtualMachine | {memoryInGB, numberCPUs, type}}'Erwartet:
{"engine":"containerd","k8s":"1.36.5","vm":{"memoryInGB":6,"numberCPUs":4,"type":"vz"}}
Alles, was das Fenster einstellt, liegt in diesen Settings.
rdctl set ändert sie ebenso ohne Fenster, praktisch für
Skripte und die Einrichtung vieler Rechner.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Verwaltete Einstellungen: Unternehmen geben Rancher Desktop per MDM feste Vorgaben mit, etwa Laufzeit, Kubernetes-Version oder gesperrte Registries.
- Lizenz: Rancher Desktop ist Open Source und für den Einsatz in Firmen frei, anders als manche Desktop-Alternative.
- Gleiche Basis: Auf dem Laptop k3s, im Rechenzentrum k3s oder RKE2: Was lokal läuft, läuft später ähnlich, wenn auch nicht gleich (Rechte, Speicher, Netz).
- Aufräumen:
rdctl factory-resetlöscht VM und Images; die Deinstallation per Homebrew braucht Administratorrechte.