Tag 1: Linkerd installieren
Ziel: Die Linkerd-CLI und die Control Plane laufen,
linkerd checkist grün und du weißt, was im Namespacelinkerdarbeitet. · Dauer: ca. 45 min · Voraussetzung: Tag 0
Briefing
- Linkerd besteht aus der Control Plane (Namespace
linkerd) und einem Proxy neben jedem Pod im Mesh. Der Proxy ist in Rust geschrieben und wird nur von Linkerd konfiguriert. - Das Open-Source-Projekt veröffentlicht nur noch
Edge-Releases, etwa jede Woche oder zwei, Name
edge-JJ.MM.N. Stabile Versionen (2.x) bauen Anbieter selbst, zum Beispiel Buoyant mit „Buoyant Enterprise for Linkerd“ (Konto nötig). - Das Buch nutzt
edge-26.11.2und pinnt diese Version überall. Edge heißt nicht „instabil“, aber: Lies vor jedem Wechsel die Release Notes. - Installiert wird in zwei Schritten: erst die CRDs, dann die Control Plane.
Drill 1: Die CLI holen
mkdir -p ~/linkerd/tag01 && cd ~/linkerd/tag01
ARCH=$(dpkg --print-architecture)
V=edge-26.11.2
curl -fsSLO \
https://github.com/linkerd/linkerd2/releases/download/$V/linkerd2-cli-$V-linux-$ARCH
sha256sum linkerd2-cli-$V-linux-$ARCH
curl -fsSL https://api.github.com/repos/linkerd/linkerd2/releases/tags/$V \
| grep -o '"digest": "sha256:[0-9a-f]*"'Erwartet (gekürzt):
4596473d74406298eb5c0123cf710d2834b726487996a9e8fa8859ccda3b360e linkerd2-cli-edge-...
"digest": "sha256:a2f8cd76f157e6a3043d997c2a8ac338ded2b94c8dfc54ce4fd525c973574403"
"digest": "sha256:489834f8fe8e0485987560ac5005c1061a71e44127cb872f009356dfbcba7380"
"digest": "sha256:4596473d74406298eb5c0123cf710d2834b726487996a9e8fa8859ccda3b360e"
Die Releases haben keine eigene Prüfsummendatei. GitHub zeigt aber zu jeder Datei den SHA-256-Wert. Deine Summe muss in der Liste stehen – auf arm64 ist es eine andere Zeile.
sudo install -m 0755 linkerd2-cli-$V-linux-$ARCH /usr/local/bin/linkerd
linkerd version --clientErwartet:
Client version: edge-26.11.2
Tipp: Das offizielle Skript
curl … run.linkerd.io/install-edge | shinstalliert immer die neueste Edge-Version nach~/.linkerd2/bin. Für ein Labor mit festen Versionen ist der direkte Download besser.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Vorab prüfen
linkerd check --preErwartet (gekürzt):
kubernetes-version
------------------
√ is running the minimum Kubernetes API version
gateway-api-crd
---------------
√ Gateway API CRDs are installed
pre-kubernetes-setup
--------------------
√ control plane namespace does not already exist
...
Status check results are √
Die Prüfung kennt nur eine Mindestversion von Kubernetes. Die Doku nennt außerdem die Versionen, die das Projekt getestet hat. Neuere Versionen wie 1.37 funktionieren meist, sind aber offiziell nicht geprüft. Dieses Buch lief vollständig auf 1.37.2.
Linkerd braucht die Gateway-API-CRDs, installiert sie aber nicht selbst. Auf diesem Cluster hat Cilium sie mitgebracht:
kubectl get crd httproutes.gateway.networking.k8s.io -o \
jsonpath='{.metadata.annotations.gateway\.networking\.k8s\.io/bundle-version}{"\n"}'Erwartet:
v1.6.3
Fehlen sie, installierst du sie aus dem Release von
kubernetes-sigs/gateway-api (standard-install.yaml), bevor
es weitergeht.
Fortschritt speichern? Kostenlos registrieren
Drill 3: CRDs installieren
linkerd install --crds > crds.yaml
grep -c '^kind: CustomResourceDefinition' crds.yaml
kubectl apply -f crds.yamlErwartet (gekürzt):
10
customresourcedefinition…/authorizationpolicies.policy.linkerd.io created
customresourcedefinition…/egressnetworks.policy.linkerd.io created
customresourcedefinition…/httplocalratelimitpolicies.policy.linkerd.io created
customresourcedefinition…/httproutes.policy.linkerd.io created
customresourcedefinition…/meshtlsauthentications.policy.linkerd.io created
customresourcedefinition…/networkauthentications.policy.linkerd.io created
customresourcedefinition…/serverauthorizations.policy.linkerd.io created
customresourcedefinition…/servers.policy.linkerd.io created
customresourcedefinition…/serviceprofiles.linkerd.io created
customresourcedefinition…/externalworkloads.workload.linkerd.io created
Warum getrennt? CRDs leben länger als jede Version der Control Plane. Bei einem Upgrade kommen sie zuerst, damit die neue Control Plane ihre Typen schon vorfindet.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Die Control Plane
linkerd install > control-plane.yaml
grep '^kind:' control-plane.yaml | sort | uniq -cErwartet:
5 kind: ClusterRole
5 kind: ClusterRoleBinding
2 kind: ConfigMap
1 kind: CronJob
3 kind: Deployment
1 kind: MutatingWebhookConfiguration
1 kind: Namespace
3 kind: Role
2 kind: RoleBinding
5 kind: Secret
8 kind: Service
4 kind: ServiceAccount
2 kind: ValidatingWebhookConfiguration
Schau dir die Datei an, bevor du sie anwendest – 2300 Zeilen, aber nur drei Deployments. Dann:
kubectl apply -f control-plane.yaml
kubectl -n linkerd rollout status deploy --timeout=300s
kubectl -n linkerd get pods -o wideErwartet (gekürzt):
deployment "linkerd-destination" successfully rolled out
deployment "linkerd-identity" successfully rolled out
deployment "linkerd-proxy-injector" successfully rolled out
NAME READY STATUS RESTARTS AGE IP ...
linkerd-destination-5dcfd8f776-xlkh4 4/4 Running 0 64s ...
linkerd-identity-59c56c964b-w6nsj 2/2 Running 0 64s ...
linkerd-proxy-injector-86b67d54f6-lhshl 2/2 Running 0 64s ...
| Deployment | Aufgabe |
|---|---|
linkerd-identity |
Zertifizierungsstelle: stellt jedem Proxy ein mTLS-Zertifikat aus |
linkerd-destination |
sagt Proxys, wohin ein Service zeigt und welche Policy gilt |
linkerd-proxy-injector |
Webhook, der Pods beim Anlegen den Proxy hinzufügt |
Fortschritt speichern? Kostenlos registrieren
Drill 5: Alles prüfen
linkerd checkErwartet (gekürzt):
linkerd-identity
----------------
√ certificate config is valid
√ trust anchors are using supported crypto algorithm
√ trust anchors are within their validity period
√ trust anchors are valid for at least 60 days
√ issuer cert is using supported crypto algorithm
...
control-plane-version
---------------------
√ can retrieve the control plane version
√ control plane is up-to-date
√ control plane and cli versions match
...
Status check results are √
linkerd versionErwartet:
Client version: edge-26.11.2
Server version: edge-26.11.2
Fortschritt speichern? Kostenlos registrieren
Drill 6: In die Control Plane schauen
kubectl -n linkerd get pod -l linkerd.io/control-plane-component=destination \
-o jsonpath='{range .items[0].spec.initContainers[*]}init:{.name} {end}
{range .items[0].spec.containers[*]}{.name} {end}{"\n"}'
kubectl -n linkerd get pod -l linkerd.io/control-plane-component=destination \
-o jsonpath='{.items[0].spec.initContainers[*].restartPolicy}{"\n"}'Erwartet:
init:linkerd-init init:linkerd-proxy
destination sp-validator policy
Always
Drei Dinge fallen auf:
- Auch die Control Plane hat Proxys – sie ist selbst Teil des Mesh.
linkerd-initsetzt iptables-Regeln, die allen Verkehr des Pods durch den Proxy leiten. Dafür braucht er die CapabilityNET_ADMIN. Darf er das nicht, gibt es das Linkerd-CNI-Plugin als Alternative.linkerd-proxyist ein nativer Sidecar: ein Init-Container mitrestartPolicy: Always. Er startet vor der App und läuft dann weiter.
Die Zertifikate liegen hier:
kubectl -n linkerd get secret,configmap | grep -E 'identity|config'Erwartet:
secret/linkerd-config-overrides Opaque 1 2m
secret/linkerd-identity-issuer Opaque 2 2m
configmap/linkerd-config 2 2m
configmap/linkerd-identity-trust-roots 1 2m
linkerd install hat selbst ein einziges selbstsigniertes
Zertifikat erzeugt, das zugleich Trust Anchor und Issuer ist. Das ist
bequem, aber nicht für Produktion gedacht – an Tag 5 ersetzt du es durch
einen eigenen Anchor und Issuer.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Zeig nur die Versionsnummern von CLI und Control Plane. Zeitziel: 10 s
- Zähl die Linkerd-CRDs im Cluster. Zeitziel: 20 s
- Zeig die Webhooks, die Linkerd registriert hat. Zeitziel: 30 s
- Zeig CPU und Speicher der Control Plane. Zeitziel: 15 s
Lösung
linkerd version --short
kubectl get crd -o name | grep -c linkerd
kubectl get mutatingwebhookconfigurations,validatingwebhookconfigurations | grep linkerd
kubectl top pods -n linkerdErwartet (Auszug für 1, 2 und 4):
edge-26.11.2
edge-26.11.2
10
NAME CPU(cores) MEMORY(bytes)
linkerd-destination-5dcfd8f776-xlkh4 9m 34Mi
linkerd-identity-59c56c964b-w6nsj 2m 14Mi
linkerd-proxy-injector-86b67d54f6-lhshl 2m 17Mi
Rund 65 MiB für die ganze Control Plane – das ist der Grund für den Ruf „leichtes Mesh“.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
linkerd check 2>&1 | tail -1Erwartet:
Status check results are √
kubectl -n linkerd get deployErwartet:
NAME READY UP-TO-DATE AVAILABLE AGE
linkerd-destination 1/1 1 1 5m
linkerd-identity 1/1 1 1 5m
linkerd-proxy-injector 1/1 1 1 5m
kubectl -n notes get pods -l app=web -o jsonpath='{.items[0].spec.containers[*].name}'Erwartet: nur web – die App ist noch
nicht im Mesh. Das ändert sich an Tag 2.
Challenge
Erzeuge das Manifest für eine hochverfügbare Control Plane, ohne den Cluster zu ändern, und finde heraus, was sich gegenüber deiner Installation unterscheidet.
Hinweis: linkerd install verweigert
sich, wenn Linkerd schon läuft – es sei denn, du sagst ihm, dass es den
Cluster ignorieren soll.
Lösung
cd ~/linkerd/tag01
linkerd install --ha --ignore-cluster > ha.yaml
grep -E '^ replicas:' control-plane.yaml | sort | uniq -c
grep -E '^ replicas:' ha.yaml | sort | uniq -c
grep -c 'kind: PodDisruptionBudget' ha.yamlErwartet:
3 replicas: 1
3 replicas: 3
3
Im HA-Modus läuft jedes Deployment dreimal, mit PodDisruptionBudgets und Anti-Affinity. Auf diesem Cluster mit zwei Workern wäre das zu viel – Tag 14 zeigt die HA-Installation mit Helm.
Fortschritt speichern? Kostenlos registrieren
Interview-Notiz
- Welche Komponenten hat die Linkerd-Control-Plane? identity (CA), destination (Service-Discovery und Policy), proxy-injector (Webhook).
- Was ist der Unterschied zwischen Edge und Stable? Das Projekt baut nur Edge-Releases. Stabile Versionen mit Support liefern Anbieter.
- Warum CRDs getrennt installieren? Damit Upgrades der Control Plane nie auf fehlende oder veraltete Typen treffen.
Enterprise-Notiz
- Produktion installiert per Helm (Charts
linkerd-crdsundlinkerd-control-plane) oder GitOps – nicht perlinkerd install | kubectl apply(Tag 14). - Trust Anchor und Issuer kommen aus einer eigenen PKI oder
cert-manager, nicht aus
linkerd install(Tag 5). - Edge-Versionen regelmäßig nachziehen: Ein Mesh, das ein Jahr nicht aktualisiert wird, ist schwerer zu upgraden als zwölf kleine Schritte.
- Ohne
NET_ADMINfür Pods (Pod Security „restricted“) brauchst du das Linkerd-CNI-Plugin. Mit Cilium muss danncni.exclusive=falsegesetzt sein, sonst löscht Cilium dessen Konfiguration.