Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: Linkerd installieren

Ziel: Die Linkerd-CLI und die Control Plane laufen, linkerd check ist grün und du weißt, was im Namespace linkerd arbeitet. · 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.2 und 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 --client

Erwartet:

Client version: edge-26.11.2

Tipp: Das offizielle Skript curl … run.linkerd.io/install-edge | sh installiert 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 --pre

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

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

Erwartet:

      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 wide

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

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

Erwartet:

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-init setzt iptables-Regeln, die allen Verkehr des Pods durch den Proxy leiten. Dafür braucht er die Capability NET_ADMIN. Darf er das nicht, gibt es das Linkerd-CNI-Plugin als Alternative.
  • linkerd-proxy ist ein nativer Sidecar: ein Init-Container mit restartPolicy: 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

  1. Zeig nur die Versionsnummern von CLI und Control Plane. Zeitziel: 10 s
  2. Zähl die Linkerd-CRDs im Cluster. Zeitziel: 20 s
  3. Zeig die Webhooks, die Linkerd registriert hat. Zeitziel: 30 s
  4. 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 linkerd

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

Erwartet:

Status check results are √
kubectl -n linkerd get deploy

Erwartet:

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.yaml

Erwartet:

      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-crds und linkerd-control-plane) oder GitOps – nicht per linkerd 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_ADMIN für Pods (Pod Security „restricted“) brauchst du das Linkerd-CNI-Plugin. Mit Cilium muss dann cni.exclusive=false gesetzt sein, sonst löscht Cilium dessen Konfiguration.