Tag 0: Das Trainingsgelände
Ziel: Ein Single-Node-k3s mit Helm 4, einem eigenen Kontext und einem leeren Chart-Repo – auf einer VM, auf der schon andere Dienste laufen, die du nicht störst. · Dauer: ca. 45 min · Voraussetzung: Ubuntu-24.04-VM mit 2 vCPU und 4 GB RAM
Briefing
- Helm ist ein Programm auf deinem Rechner, kein Dienst im Cluster. Es nutzt dein kubeconfig und deine Rechte – auch den Kontext, in dem du gerade bist.
- Das ganze Buch läuft auf einer VM
prod(172.16.0.123). Dort laufen schon RustFS (:9000) und PostgreSQL (127.0.0.1:5432) aus einem anderen Buch. Die bleiben unberührt. - Heute: k3s gepinnt installieren, Kontext
helm-lab, Helm 4.3.2 mit Prüfsumme, ein git-Repo für das Chartnotes, das ab Tag 2 Tag für Tag wächst.
VM prod 172.16.0.123 (2 vCPU, 3,8 GiB)
┌────────────────────────────────────────────────────────────────────┐
│ Host (nicht anfassen): rustfs :9000 postgresql@18 127.0.0.1:5432 │
│ k3s v1.37.2 (:6443) Traefik :80/:443 local-path-StorageClass │
│ helm 4.3.2 · yq · ~/helm/charts (git) │
└────────────────────────────────────────────────────────────────────┘
Drill 1: Die VM prüfen
Bevor du etwas installierst, schaust du, was schon da ist und wie viel Platz bleibt.
# auf prod
free -m
ss -tlnp | grep -E ':(80|443|6443|10250|30500|9000|5432) '
systemctl is-active rustfs postgresql@18-main
sudo ls -l /etc/rancher/node/
ls /var/lib/rancher | wc -lErwartet:
total used free shared buff/cache available
Mem: 3915 517 1831 64 1883 3398
Swap: 0 0 0
LISTEN 0 200 127.0.0.1:5432 0.0.0.0:*
LISTEN 0 4096 *:9000 *:*
LISTEN 0 200 [::1]:5432 [::]:*
active
active
total 4
-rw------- 1 root root 33 Nov 14 20:35 password
0
Rund 3,3 GiB sind frei, die Ports für k3s (6443, 10250, 80, 443) und
die spätere Registry (30500) sind unbelegt.
/etc/rancher/node/password ist der Rest eines früheren
k3s-Versuchs ohne Binary, Unit oder Daten. Er stört nicht: k3s nimmt die
Datei als Node-Passwort und legt im Cluster ein passendes Secret dazu
an.
Fortschritt speichern? Kostenlos registrieren
Drill 2: k3s gepinnt installieren
Gepinnt heißt: Das Buch und dein Labor laufen mit derselben Version. Den metrics-server lässt du weg, er kostet RAM und wird nicht gebraucht. Traefik bleibt für den Ingress in Tag 5.
# auf prod
curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=v1.37.2+k3s1 sh -s - \
--write-kubeconfig-mode 644 --disable metrics-server
sleep 60
kubectl get nodes
kubectl get pods -A
kubectl get storageclassErwartet (gekürzt):
[INFO] Verifying binary download
[INFO] Installing k3s to /usr/local/bin/k3s
[INFO] Creating /usr/local/bin/kubectl symlink to k3s
[INFO] systemd: Starting k3s
NAME STATUS ROLES AGE VERSION
prod Ready control-plane 51s v1.37.2+k3s1
NAMESPACE NAME READY STATUS RESTARTS
kube-system coredns-577d995dff-drvb6 1/1 Running 0
kube-system helm-install-gateway-api-crd-j4xkk 0/1 Completed 0
kube-system helm-install-traefik-crd-6dzgs 0/1 Completed 0
kube-system helm-install-traefik-n9tvs 0/1 Completed 2
kube-system local-path-provisioner-56c6584955-g64fg 1/1 Running 0
kube-system svclb-traefik-b963be7f-j6f2c 2/2 Running 0
kube-system traefik-68df944ff7-z8wmq 1/1 Running 0
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ...
local-path (default) rancher.io/local-path Delete WaitForFirstConsumer
Die Pods helm-install-… sind schon Helm: k3s installiert
Traefik und die Gateway-API-CRDs selbst als Helm-Releases. Ein Neustart
des Traefik-Jobs ist normal – er wartet auf die CRDs.
Fortschritt speichern? Kostenlos registrieren
Drill 3: kubeconfig und Kontext helm-lab
# auf prod
mkdir -p ~/.kube
cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
chmod 600 ~/.kube/config
kubectl config rename-context default helm-labErwartet:
error: open /etc/rancher/k3s/k3s.yaml.lock: permission denied
Das kubectl von k3s ist ein Link auf das k3s-Binary und
liest ohne KUBECONFIG immer
/etc/rancher/k3s/k3s.yaml – deine Kopie ignoriert es. Helm
dagegen liest ~/.kube/config. Damit beide dieselbe Datei
sehen, setzt du die Variable:
# auf prod
echo 'export KUBECONFIG=$HOME/.kube/config' >> ~/.bashrc
export KUBECONFIG=$HOME/.kube/config
kubectl config rename-context default helm-lab
kubectl config get-contextsErwartet:
Context "default" renamed to "helm-lab".
CURRENT NAME CLUSTER AUTHINFO NAMESPACE
* helm-lab default default
Fortschritt speichern? Kostenlos registrieren
Drill 4: Helm 4 mit Prüfsumme
Kein Installationsskript: Du lädst das Archiv für deine Architektur, prüfst die SHA-256-Summe und legst das Binary selbst ab.
# auf prod
mkdir -p ~/helm/tag00 && cd ~/helm/tag00
ARCH=$(dpkg --print-architecture)
HELM=v4.3.2
curl -sLO https://get.helm.sh/helm-$HELM-linux-$ARCH.tar.gz
curl -sLO https://get.helm.sh/helm-$HELM-linux-$ARCH.tar.gz.sha256sum
sha256sum -c helm-$HELM-linux-$ARCH.tar.gz.sha256sum
tar -xzf helm-$HELM-linux-$ARCH.tar.gz
sudo install -m 0755 linux-$ARCH/helm /usr/local/bin/helm
helm versionErwartet:
helm-v4.3.2-linux-amd64.tar.gz: OK
version.BuildInfo{Version:"v4.3.2", GitCommit:"8346aaa55e71…", GitTreeState:"clean",
GoVersion:"go1.27.4", KubeClientVersion:"v1.37"}
KubeClientVersion ist die Version der
Kubernetes-Bibliotheken in Helm. Helm 4.3 ist für Cluster bis 1.37
gebaut und getestet.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Wo Helm seine Dinge ablegt
# auf prod
helm envErwartet (gekürzt):
HELM_CACHE_HOME="/home/ubuntu/.cache/helm"
HELM_CONFIG_HOME="/home/ubuntu/.config/helm"
HELM_DATA_HOME="/home/ubuntu/.local/share/helm"
HELM_KUBECONTEXT=""
HELM_MAX_HISTORY="10"
HELM_NAMESPACE="default"
HELM_PLUGINS="/home/ubuntu/.local/share/helm/plugins"
HELM_REGISTRY_CONFIG="/home/ubuntu/.config/helm/registry/config.json"
HELM_REPOSITORY_CONFIG="/home/ubuntu/.config/helm/repositories.yaml"
Repos stehen unter ~/.config/helm, heruntergeladene
Indizes und Charts unter ~/.cache/helm, Plugins unter
~/.local/share/helm. Die Releases selbst liegen nicht hier,
sondern als Secrets im Cluster. HELM_MAX_HISTORY="10": Helm
4 behält standardmäßig nur zehn Revisionen pro Release.
# auf prod
helm list -AErwartet (gekürzt):
NAME NAMESPACE REVISION STATUS CHART
gateway-api-crd kube-system 1 deployed gateway-api-crd-1.6.301
traefik kube-system 1 deployed traefik-41.6.101+up41.6.1
traefik-crd kube-system 1 deployed traefik-crd-41.6.101+up41.6.1
Drei Releases, bevor du selbst etwas installiert hast. Merke dir die Gateway-API-CRDs: In Tag 4 fragt dein Chart danach.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Die Kontext-Falle
Helm nimmt ohne Rückfrage den aktuellen Kontext – und dessen Namespace. Du spielst nach, dass du gerade noch beim Kunden warst:
# auf prod
kubectl config set-context kunde-prod --cluster=default --user=default \
--namespace=kube-system
kubectl config use-context kunde-prod
helm list --short
helm env | grep -E 'NAMESPACE|KUBECONTEXT'Erwartet:
Context "kunde-prod" created.
Switched to context "kunde-prod".
gateway-api-crd
traefik
traefik-crd
HELM_KUBECONTEXT=""
HELM_NAMESPACE="kube-system"
Ohne -n arbeitet Helm jetzt in kube-system.
Ein helm uninstall traefik an dieser Stelle legt den
Ingress des Clusters lahm. In Skripten und CI setzt du darum beides
ausdrücklich:
# auf prod
helm list --short --kube-context helm-lab -n default
helm list --short --kube-context helm-lab -n kube-system -f '^traefik$'
kubectl config use-context helm-lab
kubectl config delete-context kunde-prodErwartet:
traefik
Switched to context "helm-lab".
deleted context kunde-prod from /home/ubuntu/.kube/config
In default gibt es noch keinen Release, die erste Zeile
bleibt leer. -f ist ein regulärer Ausdruck:
-f traefik träfe auch traefik-crd.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Werkzeuge und Chart-Repo
yq brauchst du für kleine Änderungen an Chart-Dateien,
tree zum Anschauen. Das Chart lebt in einem git-Repo – ein
Commit pro Tag, damit du jederzeit vergleichen kannst.
# auf prod
cd ~/helm/tag00
ARCH=$(dpkg --print-architecture)
YQ=v4.54.3
curl -sLo yq https://github.com/mikefarah/yq/releases/download/$YQ/yq_linux_$ARCH
curl -sLo yq-checksums \
https://github.com/mikefarah/yq/releases/download/$YQ/checksums
grep "^yq_linux_$ARCH " yq-checksums | grep -c "$(sha256sum yq | cut -d' ' -f1)"
sudo install -m 0755 yq /usr/local/bin/yq
sudo apt-get install -y tree >/dev/null
yq --versionErwartet:
1
yq (https://github.com/mikefarah/yq/) version v4.54.3
Die Prüfsummendatei von yq enthält pro Datei viele Hash-Arten in
Spalten. Die 1 heißt: Die SHA-256-Summe deines Downloads
steht in der Zeile für deine Architektur.
# auf prod
mkdir -p ~/helm/charts && cd ~/helm/charts
git init -b main
git config --global user.name "Helm Lab"
git config --global user.email [email protected]
printf '*.tgz\n' > .gitignore
git add .gitignore
git commit -qm "Tag 00: leeres Chart-Repo"
git log --onelineErwartet:
Initialized empty Git repository in /home/ubuntu/helm/charts/.git/
eeb85c7 Tag 00: leeres Chart-Repo
Zum Schluss misst du, was k3s gekostet hat:
# auf prod
free -m
ps -eo rss,comm --sort=-rss | head -6Erwartet (gekürzt):
total used free shared buff/cache available
Mem: 3915 1169 320 65 2759 2746
RSS COMMAND
683632 k3s-server
184716 containerd
144944 rustfs
101500 traefik
60060 coredns
k3s mit Traefik kostet rund 650 MiB. Gut 2,6 GiB bleiben für zot, das
Chart notes und die Experimente der nächsten Tage. Fällt
available später unter 800 MiB, räumst du
Wegwerf-Namespaces auf.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Zeig, wo Helm seine Repo-Liste speichert. Zeitziel: 10 s
- Zähl alle Helm-Releases im Cluster. Zeitziel: 20 s
- Zeig nur den Release
traefik, nichttraefik-crd. Zeitziel: 20 s - Prüfe, dass RustFS und PostgreSQL noch laufen. Zeitziel: 15 s
Lösung
# auf prod
helm env HELM_REPOSITORY_CONFIG
helm list -A -o json | jq length
helm list -n kube-system -f '^traefik$'
systemctl is-active rustfs postgresql@18-mainErwartet (gekürzt):
/home/ubuntu/.config/helm/repositories.yaml
3
NAME NAMESPACE REVISION UPDATED STATUS CHART
traefik kube-system 1 ... deployed traefik-41.6.101+up41.6.1
active
active
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
# auf prod
kubectl config current-contextErwartet: helm-lab
# auf prod
helm version --shortErwartet: v4.3.2+g8346aaa
# auf prod
kubectl get nodesErwartet:
NAME STATUS ROLES AGE VERSION
prod Ready control-plane 3m32s v1.37.2+k3s1
# auf prod
systemctl is-active rustfs postgresql@18-main k3sErwartet: dreimal active.
Challenge
Finde heraus, wer den Release traefik installiert hat,
aus welchem Paket und mit welchen Werten – nur mit helm und
kubectl.
Hinweis: k3s bringt einen eigenen Helm-Controller mit einer eigenen Ressource mit.
Lösung
# auf prod
helm history traefik -n kube-system
helm get values traefik -n kube-system | head -8
kubectl -n kube-system get secret -l owner=helm
kubectl get helmcharts -n kube-system traefik -o jsonpath='{.spec.chart}{"\n"}'Erwartet (gekürzt):
REVISION UPDATED STATUS CHART DESCRIPTION
1 Fri Nov 20 00:47:29 2026 deployed traefik-41.6.101+up41.6.1 Install co…
USER-SUPPLIED VALUES:
deployment:
podAnnotations:
prometheus.io/port: "8082"
prometheus.io/scrape: "true"
global:
systemDefaultRegistry: ""
NAME TYPE DATA AGE
sh.helm.release.v1.gateway-api-crd.v1 helm.sh/release.v1 1 2m38s
sh.helm.release.v1.traefik-crd.v1 helm.sh/release.v1 1 2m41s
sh.helm.release.v1.traefik.v1 helm.sh/release.v1 1 2m25s
https://%{KUBERNETES_API}%/static/charts/traefik-41.6.101+up41.6.1.tgz
Die Ressource HelmChart (helm.cattle.io)
beschreibt den gewünschten Release, der k3s-Helm-Controller führt ihn
mit einem Job aus. Das Ergebnis ist ein ganz normaler Release: ein
Secret sh.helm.release.v1.<name>.v<revision>
mit owner=helm. Ändere Traefik deshalb nie mit
helm upgrade – der Controller würde es zurückdrehen. Was in
diesen Secrets steht, zerlegst du in Tag 13.
Fortschritt speichern? Kostenlos registrieren
Interview-Notiz
- Läuft Helm im Cluster? Nein. Seit Helm 3 gibt es kein Tiller mehr; der Client spricht direkt mit der API, mit den RBAC-Rechten des Nutzers. Releases speichert er als Secrets im Namespace des Releases.
- Wie verhinderst du, im falschen Cluster zu installieren? In
Skripten und CI immer
--kube-contextund-nsetzen, nie auf den aktuellen Kontext verlassen.
Enterprise-Notiz
- Helm-Version in CI und auf Admin-Rechnern pinnen und per Prüfsumme
installieren – nie
curl | bashmit „latest“. - Helm 3 bekommt nur noch Sicherheitsupdates bis 10. Februar 2027. Die Migration auf Helm 4 zeigt Tag 14.
- Ein kubeconfig pro Umgebung (oder Werkzeuge wie kubie/kubectx) statt einer Datei mit allen Produktionsclustern.
- Distributionen wie k3s, RKE2 oder OpenShift installieren eigene Komponenten per Helm oder Operator. Diese Releases gehören der Plattform, nicht dir.