Zum Inhalt springen
Trainingslager IT-Trainingslager

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 Chart notes, 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 -l

Erwartet:

               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 storageclass

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

Erwartet:

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

Erwartet:

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 version

Erwartet:

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 env

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

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

Erwartet:

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 --version

Erwartet:

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 --oneline

Erwartet:

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 -6

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

  1. Zeig, wo Helm seine Repo-Liste speichert. Zeitziel: 10 s
  2. Zähl alle Helm-Releases im Cluster. Zeitziel: 20 s
  3. Zeig nur den Release traefik, nicht traefik-crd. Zeitziel: 20 s
  4. 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-main

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

Erwartet: helm-lab

# auf prod
helm version --short

Erwartet: v4.3.2+g8346aaa

# auf prod
kubectl get nodes

Erwartet:

NAME   STATUS   ROLES           AGE     VERSION
prod   Ready    control-plane   3m32s   v1.37.2+k3s1
# auf prod
systemctl is-active rustfs postgresql@18-main k3s

Erwartet: 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-context und -n setzen, nie auf den aktuellen Kontext verlassen.

Enterprise-Notiz

  • Helm-Version in CI und auf Admin-Rechnern pinnen und per Prüfsumme installieren – nie curl | bash mit „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.