Zum Inhalt springen
Trainingslager IT-Trainingslager

Vorwort

Ein Service Mesh verspricht viel: mTLS zwischen allen Diensten, ohne die App anzufassen, Erfolgsquoten und Latenzen für jede Verbindung, Retries, Timeouts, Canary-Releases, Policies auf Basis von Identitäten und Dienste, die über Clustergrenzen hinweg erreichbar sind. Ob das stimmt, siehst du erst im Betrieb. Dann läuft ein Init-Container plötzlich am Proxy vorbei, ein Retry verdreifacht die Last auf einen Dienst, der ohnehin am Boden liegt, der Issuer läuft nachts ab, oder ein einziger falscher ServiceAccount sperrt eine ganze Kette mit 403 aus. Dieses Buch bereitet dich auf genau diese Momente vor – nicht mit Folien, sondern im Terminal.

Du betreibst Linkerd in einem echten Cluster, an einer kleinen App aus vier Diensten, die absichtlich Fehler macht. Jede Funktion beginnt mit einer Messung ohne sie und endet mit einer Messung mit ihr: Erfolgsquote im Lastgenerator, linkerd viz stat, Prometheus, ein Mitschnitt mit tcpdump. Was du nicht nachweisen kannst, hast du nicht konfiguriert.

Das Buch richtet sich an Plattform- und DevOps-Engineers mit Kubernetes-Grundlagen: Du solltest Deployments, Services und ServiceAccounts kennen, YAML lesen, kubectl bedienen und ein Helm-Chart installieren können. Wie TLS-Zertifikate grundsätzlich funktionieren, solltest du ungefähr wissen; alles, was Linkerd daraus macht, lernst du hier. Ein Service Mesh musst du noch nie betrieben haben.

So funktioniert das Buch

  • Ein Tag, ein Thema. Jeder Tag hat ein Ziel, eine Zeitangabe, ein kurzes Briefing und 5–8 Drills. Du tippst jeden Befehl selbst und vergleichst mit „Erwartet“.
  • Vorher, konfigurieren, nachher. Jede Funktion endet mit einem Nachweis: eine Zeile im Lastgenerator, eine Metrik des Proxys, ein Paket auf dem Draht.
  • Kein Hilfsskript. Jeder Schritt steht als einzelner Befehl da, auch der Kontrollpunkt am Ende jedes Tages. Manifeste schreibst du per Heredoc in Dateien.
  • Speed-Drills am Ende jedes Tages: kleine Aufgaben mit Zeitziel.
  • Kontrollpunkt, Challenge, Interview-Notiz, Enterprise-Notiz schließen jeden Tag ab. Der Kontrollpunkt prüft mit einzelnen Befehlen, ob dein Cluster im erwarteten Zustand ist – die nächsten Tage bauen darauf auf. Die Challenge ist eine Aufgabe ohne Anleitung, mit Hinweis und Lösung. Die Interview-Notiz sammelt die Fragen, die im Vorstellungsgespräch oder im Bereitschaftsdienst fallen, samt Kernantwort. Die Enterprise-Notiz sagt, was in Produktion anders ist als im Labor.
  • Eine App durch alle Tage: notes mit web (nginx), notes-api (Go), helper (go-httpbin, scheitert bei 30 Prozent der Aufrufe) und postgres. Der Lastgenerator last schreibt jeden Statuscode ins Log – das ist dein Messgerät. Tage, die etwas kaputt machen, arbeiten in einer Kopie im eigenen Namespace.

Zum Schluss:

  • Wettkampf (Tag 18): ein kaputtes Mesh, das du unter Zeitdruck reparierst.
  • Anhang A ist der Spickzettel, Anhang B die Abschlussprüfung mit Aufgaben quer durch das Buch.

Die Tage im Überblick

Tag Thema Dauer
0 Trainingsgelände: Cluster prüfen, App notes, Baseline ohne Mesh ca. 45 min
1 Linkerd installieren: CLI, CRDs, Control Plane, linkerd check ca. 45 min
2 Pods ins Mesh holen: Injection, nativer Sidecar, Opaque Ports ca. 60 min
3 mTLS und Identität: Zertifikate der Proxys, Nachweis mit tcpdump ca. 60 min
4 Beobachten: linkerd-viz, Prometheus, Grafana, tap ca. 75 min
5 Zertifikate: eigener Trust Anchor, Rotation, cert-manager ca. 90 min
6 Autorisierung: Server, AuthorizationPolicy, Default-Deny ca. 75 min
7 Retries und Timeouts mit HTTPRoutes ca. 60 min
8 Circuit Breaking und Rate Limiting ca. 60 min
9 Traffic Shifting: Canary, Header-Routing, Rollback ca. 60 min
10 Ingress mit Gateway API: Cilium-Gateway und Proxy im Mesh ca. 75 min
11 Egress: EgressNetwork, TLSRoute, HTTPRoute nach außen ca. 60 min
12 Multicluster: zweiter Cluster, Link, gespiegelte Dienste ca. 90 min
13 Multicluster: Failover und föderierte Dienste ca. 90 min
14 Linkerd mit Helm und hochverfügbar ca. 75 min
15 Upgrade und Rollback ca. 75 min
16 Fehlersuche: acht typische Mesh-Fehler ca. 90 min
17 Was das Mesh kostet: Latenz, CPU, Speicher, Proxy-Ressourcen ca. 90 min
18 Wettkampf: das kaputte Mesh ca. 90 min

Zeit: Tag 0 bis 16 summieren sich auf knapp 20 Stunden (1185 Minuten), Tag 17 und der Wettkampf kommen mit 180 Minuten dazu – insgesamt knapp 23 Stunden, plus die Abschlussprüfung. Bei einem Trainingstag pro Abend und fünf Abenden pro Woche bist du in knapp vier Wochen durch.

Die Reihenfolge ist kein Zufall: Ab Tag 6 gilt in notes Default-Deny, und jeder spätere Tag muss damit leben. Tag 12 setzt nur Tag 5 voraus (der Trust Anchor wird geteilt), Tag 13 bis 15 bauen auf Tag 12 auf, Tag 16 setzt Tag 7 voraus, Tag 17 nur Tag 4.

Das Trainingsgelände

Das Buch arbeitet mit zwei Clustern. ost ist der Hauptcluster für alle Tage, west kommt in Tag 12 für Multicluster dazu und trägt in Tag 14 und 15 die Helm-Installation. Alle Befehle laufen als ubuntu auf cp1, der Arbeitsordner ist ~/linkerd/tagNN/.

Rolle Aufgabe IP im Buch Im Labor
cp1 Control Plane ost, Arbeitsplatz 172.16.0.126 4 vCPU, 12 GB RAM
worker1 Worker ost 172.16.0.228 2 vCPU, 4 GB RAM
worker2 Worker ost 172.16.0.83 2 vCPU, 4 GB RAM
west k3s-Single-Node (ab Tag 12) 172.16.0.182 4 vCPU, 7 GB RAM
  • ost: kubeadm 1.37.2 mit drei Nodes, Cilium 1.20.5 als CNI ohne kube-proxy, Gateway API mit der Cilium-GatewayClass cilium, eine StorageClass local-path und Helm. Wie du so einen Cluster baust, zeigen „CKA zum Anfassen“ und „Cilium zum Anfassen“; hast du das Gelände noch, nimm es.
  • west: eine weitere VM mit Ubuntu 24.04, auf der Tag 12 k3s v1.37.2 als Single-Node installiert. cp1 braucht SSH-Zugang zu west (Benutzer mit sudo), Pod- und Service-Netze dürfen sich mit ost nicht überschneiden.
  • Mindestens: Die Laborwerte sind großzügig, weil auf den VMs noch Übungen aus anderen Büchern liefen. Für dieses Buch allein reichen nach unserer Einschätzung zwei Worker mit je 2 vCPU und 4 GB, eine Control Plane mit 4 vCPU und 8 GB und für west 2 vCPU und 4 GB. Kleiner haben wir nicht getestet.

Ehrlich gesagt, was die Tage voraussetzen:

  • Tag 0: Socket-Loadbalancing von Cilium darf Service-Adressen nicht im Pod umschreiben, sonst greifen Routen und Traffic Shifting nicht. Drill 2 prüft das. Mit Calico oder Flannel entfällt der Drill.
  • Tag 4: kube-prometheus-stack installierst du selbst (Release kps im Namespace monitoring). Hast du schon einen, setze Release-Namen und Namespace ein.
  • Tag 5: cert-manager v1.21.3. Läuft er nicht, steht der Installationsbefehl im Kapitel. Dazu kommen step und cmctl auf cp1, außerdem jq ab Tag 4.
  • Tag 10: ein Gateway-API-Controller. Im Labor ist das Cilium; ohne LoadBalancer-IPs greifst du per NodePort zu.
  • Tag 11: Pods brauchen Zugang ins Internet (example.com, linkerd.io).
  • Tag 13: SSH von cp1 auf die Worker (Benutzer mit sudo) für temporäre Routen.

Proxmox, VMware, eine Cloud oder Multipass – egal. Auf einem Mac mit Apple Silicon sind Multipass-VMs arm64. Linkerd und alle Images im Buch gibt es für amd64 und arm64, alle Downloads ermitteln die Architektur selbst (ARCH=$(dpkg --print-architecture)). Die Ausgaben im Buch stammen von amd64; in Dateinamen und Prüfsummen steht bei dir dann arm64.

Edge und Stable

Das Open-Source-Projekt Linkerd veröffentlicht nur Edge-Releases, etwa alle ein bis zwei Wochen, benannt nach dem Muster edge-JJ.MM.N. Die Helm-Charts tragen dieselbe Nummer als JJJJ.MM.N: edge-26.11.2 entspricht Chart 2026.11.2. Stabile Versionen mit Nummern wie 2.20.x und langfristigem Support bauen Anbieter selbst, etwa Buoyant mit „Buoyant Enterprise for Linkerd“ (Konto nötig).

Edge heißt nicht „instabil“, aber jede Version kann Verhalten ändern. Das Buch pinnt deshalb überall edge-26.11.2. Nur Tag 14 installiert auf west bewusst die Vorgängerversion edge-26.11.1, damit du in Tag 15 ein echtes Upgrade samt Rollback übst. Die Handgriffe – Release Notes lesen, CRDs zuerst, dann Control Plane, dann Datenebene – sind bei einer stabilen Version dieselben.

Versionen

Komponente Version ab Tag
Ubuntu (alle VMs) 24.04 LTS 0
Kubernetes (ost, kubeadm) v1.37.2 0
Cilium 1.20.5 0
Helm v4.3.2 0
notes-api 0.7.1 0
go-httpbin (helper) 2.26.0 0
nginx-unprivileged (web) 1.31.7-alpine 0
postgres 18.7-alpine 0
curlimages/curl (last) 8.23.0 0
Linkerd (CLI, Control Plane, viz, Multicluster) edge-26.11.2 1
Gateway-API-CRDs (von Cilium bzw. k3s) v1.6.3 1
nicolaka/netshoot v0.15 3
kube-prometheus-stack (Helm-Chart) 93.4.1 4
step (Smallstep CLI) 0.31.0 5
cert-manager v1.21.3 5
cmctl v2.6.2 5
trust-manager v0.26.0 5
notes-api (alte Version für den Canary) 0.5.2 9
k3s (west) v1.37.2+k3s1 12
Linkerd-Helm-Charts (Upgrade von → nach) 2026.11.1 → 2026.11.2 14
busybox (Banner-Dienst) 1.37 16
fortio/fortio (Lastgenerator) 1.69.5 17

Das Begleitrepo

Quellcode von notes-api und das Material zum Buch liegen unter https://github.com/thomaszachmann/linkerd-zum-anfassen. Bauen musst du nichts: Das Image ghcr.io/thomaszachmann/notes-api:0.7.1 gibt es fertig für amd64 und arm64. Manifeste und Befehle im Buch tippst du trotzdem selbst – das ist das Training.

Was du danach kannst

  • Linkerd mit CLI und Helm installieren, prüfen, hochverfügbar betreiben und ohne fehlgeschlagenen Request upgraden und zurückrollen.
  • Workloads ins Mesh holen und erkennen, wann ein Container, ein Port oder ein Protokoll am Proxy vorbeiläuft.
  • mTLS auf dem Draht nachweisen, Trust Anchor und Issuer rotieren und die Erneuerung an cert-manager übergeben.
  • Erfolgsquote, Durchsatz und Latenz jedes Dienstes mit viz, Prometheus und Grafana ablesen und einzelne Requests live verfolgen.
  • Default-Deny mit Servern und AuthorizationPolicies durchsetzen, ohne Probes und Monitoring zu brechen.
  • Retries, Timeouts, Circuit Breaking, Rate Limits, Canary-Releases, Ingress und Egress mit Gateway-API-Ressourcen steuern und ihren Preis messen.
  • Zwei Cluster mit gemeinsamem Trust Anchor verbinden, Dienste spiegeln oder föderieren und einen Clusterausfall überstehen.
  • Typische Mesh-Fehler mit linkerd check, linkerd diagnostics und dem Proxy-Log in Minuten finden.

Hinweis: Dieses Buch ist ein unabhängiges Übungsbuch. Linkerd ist ein CNCF-Projekt; Linkerd ist eine Marke der Linux Foundation. Das Buch steht in keiner Verbindung zur Linux Foundation, zur CNCF oder zu Anbietern von Linkerd-Distributionen und wird von ihnen weder geprüft noch unterstützt.

Alle Ausgaben stammen aus echten Läufen, gekürzt, wo es sinnvoll ist. Werte wie der API-Key lab-key-123, das Datenbank-Passwort lab-db-123 oder das Grafana-Passwort lab-grafana-123 sind reine Laborwerte – in Produktion gehören sie in einen Passwort-Tresor oder ein Secret, nie in ein Buch. Dasselbe gilt für den privaten Schlüssel des Trust Anchors, den du in Tag 5 erzeugst.

Viel Spaß im Trainingslager.