Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Einen Kubernetes-Workload bei SPIRE registrieren

Nach dieser Lektion: Ich kann einen Kubernetes-Workload so registrieren, dass seine Pods und nur sie sein SVID bekommen.

Lektion, 75 Min.9 BefehleLab zur Workload-Identität: SPIFFE und SPIRE auf k3s, mit mTLS zwischen Diensten, auf einer privaten Ubuntu-VM

Ein Pod, dessen Name sich ständig ändert

Einen Kubernetes-Workload bei SPIRE registrieren heißt: einen Eintrag schreiben, der seine Pods danach auswählt, was Kubernetes über sie sagt. Der Name eines Pods ändert sich bei jedem Ersatz.

Also muss der Eintrag etwas wählen, das bleibt: den Namespace und das Dienstkonto. Dann bekommt jeder neue Pod des Workloads dieselbe Identität, und kein anderer Pod.

Am Ende dieser Lektion

Notiz

Ich kann einen Kubernetes-Workload so registrieren, dass seine Pods und nur sie sein SVID bekommen.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
Namespaceeine benannte Gruppe von Kubernetes-Objektendemo
Dienstkontodie Identität, die Kubernetes einem Pod gibt (Service Account)printer
Eintrageine SPIFFE-ID, eine Parent-ID und Selektoren
hostPathein Ordner des Knotens, in einen Pod eingehängt
Workload APIder Socket des Agenten, der SVIDs ausgibt

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein Pod erreicht den Agenten über einen Socket

Der Agent läuft auf dem Knoten, außerhalb des Clusters. Ein Pod erreicht ihn über den Socket der Workload API, als hostPath-Ordner in den Pod eingehängt. In diesem Lab ist auch das Programm spire-agent eingehängt, damit ein busybox-Pod fragen kann.

Die beiden Mounts unten stecken in jedem Pod dieses Labs. Im Betrieb übernimmt oft ein CSI-Treiber dieselbe Aufgabe.

Die beiden Mounts eines Pods (ein Beispiel)

Code: bash
volumeMounts:
  - { name: spire-socket, mountPath: /tmp/spire-agent/public, readOnly: true }
  - { name: spire-bin, mountPath: /opt/spire/bin, readOnly: true }
volumes:
  - { name: spire-socket, hostPath: { path: /tmp/spire-agent/public, type: Directory } }
  - { name: spire-bin, hostPath: { path: /opt/spire/bin, type: Directory } }

Namespace, Konto und Pods anlegen

Die nächsten Runs legen den Namespace demo und das Dienstkonto printer an. Dann wendet spirelab pods zwei Deployments an: printer läuft unter diesem Konto, copier unter dem Standardkonto des Namespace.

Die beiden Runs mit rollout warten, bis jeder Pod bereit ist, und enden mit successfully rolled out. Dieser Teil braucht k3s, also eine Maschine mit 2 GB.

Den Namespace demo anlegen

Befehl
kubectl create namespace demo

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Das Dienstkonto printer anlegen

Befehl
kubectl create serviceaccount printer -n demo

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die Pods printer und copier starten

Befehl
spirelab pods

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Auf printer warten

Befehl
kubectl rollout status deployment/printer -n demo

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Auf copier warten

Befehl
kubectl rollout status deployment/copier -n demo

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein Eintrag wählt Namespace und Konto

Der Eintrag gibt spiffe://lab.test/ns/demo/sa/printer jedem Pod, der sowohl k8s:ns:demo als auch k8s:sa:printer hat. Viele benennen die ID nach Namespace und Konto, dann verrät die ID, woher sie stammt.

Warten Sie danach ein paar Sekunden und fragen Sie dann aus jedem Pod heraus.

Den Workload printer registrieren

Befehl
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/ns/demo/sa/printer -selector k8s:ns:demo -selector k8s:sa:printer

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

In printer um ein SVID bitten

Befehl
kubectl exec -n demo deploy/printer -- /opt/spire/bin/spire-agent api fetch x509

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

In copier um ein SVID bitten

Befehl
kubectl exec -n demo deploy/copier -- /opt/spire/bin/spire-agent api fetch x509

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein Pod bekam eine Identität, einer nicht

In printer gibt der Run SPIFFE ID: spiffe://lab.test/ns/demo/sa/printer aus. In copier gibt er no identity issued aus, und kubectl ergänzt command terminated with exit code 1.

Beide Pods erreichen denselben Socket. Nur die attestierten Tatsachen unterscheiden sich: copier läuft unter dem Konto default.

Ein häufiger Fehler

Warnung

Viele registrieren einen Pod bei seinem Namen, weil kubectl diesen zeigt. Der Name eines Pods aus einem Deployment ändert sich bei jedem Ersatz, also bekommt der neue Pod nichts. Wählen Sie Namespace und Dienstkonto, die bleiben.

Den Namespace demo löschen

Befehl
kubectl delete namespace demo

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Über dieses Lab und seinen Quellcode: Lab zur Workload-Identität: SPIFFE und SPIRE auf k3s, mit mTLS zwischen Diensten, auf einer privaten Ubuntu-VM

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.