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:
notesmitweb(nginx),notes-api(Go),helper(go-httpbin, scheitert bei 30 Prozent der Aufrufe) undpostgres. Der Lastgeneratorlastschreibt 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-GatewayClasscilium, eine StorageClasslocal-pathund 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.cp1braucht SSH-Zugang zuwest(Benutzer mitsudo), Pod- und Service-Netze dürfen sich mitostnicht ü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
west2 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
kpsim Namespacemonitoring). 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
stepundcmctlaufcp1, außerdemjqab 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
cp1auf die Worker (Benutzer mitsudo) 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 diagnosticsund 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.