Zum Inhalt springen
Trainingslager IT-Trainingslager

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, kubectl und helm.
  • In diesem Buch läuft Rancher Desktop mit containerd als Laufzeit. nerdctl spricht containerd so, wie docker Docker 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" version

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

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

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

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

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

Erwartet (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; echo

Erwartet: die VM läuft.

{"vmState":"STARTED","locked":false}
kubectl --context rancher-desktop get nodes

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

Erwartet: 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-reset löscht VM und Images; die Deinstallation per Homebrew braucht Administratorrechte.