Constantin, Kubernetes-Betrieb bei Pexon Consulting | 10 Min. Lesezeit | 14.09.2026
TL;DR: Kubernetes Persistent Storage ohne Folklore
Kubernetes Persistent Storage ist PV, PVC, StorageClass und ein CSI-Treiber, nicht das StatefulSet. Ein Claim bestellt Speicher, die Klasse sagt wie, CSI spricht mit der Platte. Pexon Consulting (80 Mitarbeitende, Deutschland, Microsoft Partner) startet Einsteiger bei ReadWriteOnce und WaitForFirstConsumer. local-path bleibt Test. Backup ist eine eigene Schicht, kein Häkchen in der PVC.
| Objekt | Wer spricht | Was es nicht ist |
|---|---|---|
| PersistentVolume (PV) | Cluster, Admin oder Provisioner | Die App, die Daten schreibt |
| PersistentVolumeClaim (PVC) | Namespace, Entwickler | Eine Garantie für Replica |
| StorageClass | Provisioner plus Parameter | Ein Backup-Plan |
| CSI-Treiber | Control- und Node-Plugin | In-Tree-Plugin von 2018 |
Das Problem: Pending, weil niemand eine Klasse bestellt hat
Der Pod bleibt Pending. In den Events steht pod has unbound immediate PersistentVolumeClaims. Jemand hat volumeMounts gesetzt. Niemand hat eine StorageClass, die dynamisch provisioniert. Oder die Default-Klasse ist local-path, der Node stirbt, und mit ihm das Verzeichnis.
Das ist der Einsteiger-Schnitt. Nicht Postgres-Failover, nicht local-path ehrlich betreiben. Den zweiten Text haben wir schon geschrieben: StatefulSet, Daten, local-path. Hier bleibt die Schicht darunter. PV, PVC, StorageClass, CSI. Was ein Claim bestellt. Was ReadWriteOnce wirklich erlaubt. Warum Backup kein Feld in der PVC ist.
Wir sehen denselben Ablauf in kleinen On-Prem-Setups. Drei Nodes, Rancher, Default-Klasse vom Chart. Die App „hat Storage“. Bis der erste Node rebootet.
Pexon Consulting schneidet Kubernetes Persistent Storage deshalb als Bestellung, nicht als Dateisystem-Vortrag. Wer den Claim versteht, versteht den Rest.
Kubernetes Persistent Storage: wer bestellt, wer liefert
Die kurze Antwort: der PVC ist eure Bestellung (Größe, AccessMode, Klasse). Das PV ist die Ware. Die StorageClass ist der Lieferant plus die Regeln.
Statisch heißt: ein Admin legt PVs an, Claims binden daran. Dynamisch heißt: der Claim trifft eine Klasse, der Provisioner erzeugt das Volume. 2026 ist dynamisch der Default, sobald ein CSI-Treiber läuft. Statisch bleibt für Spezialfälle, NFS-Shares, die schon da sind, oder Labs ohne Provisioner.
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: shop-data
namespace: shop
spec:
accessModes:
- ReadWriteOnce
storageClassName: csi-disk
resources:
requests:
storage: 20Gi
---
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: csi-disk
provisioner: disk.csi.azure.com
allowVolumeExpansion: true
reclaimPolicy: Retain
volumeBindingMode: WaitForFirstConsumer
parameters:
skuName: Premium_LRS
storageClassName: "" schaltet dynamisches Provisioning für diesen Claim aus. Das ist Absicht, kein Tippfehler. Ein leeres Feld ohne Anführungszeichen nimmt die Default-Klasse, falls eine Annotation storageclass.kubernetes.io/is-default-class=true gesetzt ist. Zwei Defaults ergeben die zuletzt angelegte Klasse. Das ist ein guter Weg, sich zu wundern.
ReclaimPolicy Delete räumt PV und Backend weg, wenn der Claim stirbt. Retain lässt die Platte liegen. Für Testdaten ist Delete ehrlich. Für Rechnungsläufe ist Delete die teure Bequemlichkeit. Wir setzen Retain, sobald jemand „die Daten sind wichtig“ sagt und noch kein Restore-Lauf existiert.
Kubernetes 1.36 hat VolumeAttributesClass auf storage.k8s.io/v1 gelegt und mutable CSI-Attach-Limits auf GA. In-Tree-Portworx ist dort raus. 1.37.0 (Garhwal) kam am 26.08.2026. Wer 2026 noch kubernetes.io/aws-ebs in die Klasse schreibt, pflegt einen Abgang, keinen Standard. CSI ist der Weg, nicht Nostalgie.
ReadWriteOnce: ein Node, nicht ein Gefühl
AccessModes sind die Stelle, an der Einsteiger uns am häufigsten anrufen.
ReadWriteOnce (RWO) hängt das Volume an einen Node. Mehrere Pods auf diesem Node können es theoretisch teilen. Zwei Pods auf zwei Nodes nicht. Der zweite bleibt Pending, Event: volume already attached. Das ist kein Scheduler-Bug. Das ist der Vertrag.
ReadWriteOncePod (RWOP) ist enger: ein Pod, nicht ein Node. Nützlich, wenn ihr RWO-Missverständnisse unterbinden wollt.
ReadWriteMany (RWX) und ReadOnlyMany brauchen ein Backend, das das kann. NFS, Azure Files, CephFS. Ein Block-Volume (Azure Disk, EBS, vSphere) wird durch Wunschdenken nicht zu RWX. Der CSI-Treiber sagt nein, oder der zweite Mount hängt.
Wir raten davon ab, ein Deployment mit replicas: 2 auf ein RWO-Volume zu setzen, „damit es hochverfügbar wird“. Ihr bekommt einen laufenden Pod und einen Pending. Hochverfügbarkeit sitzt in der App oder im Operator, nicht in zwei Replicas auf einer Platte.
WaitForFirstConsumer verschiebt Provisioning, bis ein Pod den Claim benutzt. Immediate legt das Volume sofort an, oft in der falschen Zone. Dann scheduled der Pod nicht, weil die Disk in Zone A liegt und der Node in Zone B. Für topology-bewusste CSI-Treiber ist WaitForFirstConsumer die langweilige richtige Wahl.
- AccessMode gegen das Backend halten, nicht gegen die Folie.
- RWO plus Deployment-Replicas > 1 ist der häufigste Pending.
- WaitForFirstConsumer, sobald Zonen existieren.
allowVolumeExpansion: truenur, wenn der Treiber expand kann. Verkleinern können die meisten nicht.
Offizielle Referenz: Persistent Volumes in der Kubernetes-Doku. Nicht die Blog-Kurzform, die RWO mit „ein Pod“ übersetzt.
CSI statt In-Tree: wer mit der Platte spricht
CSI trennt Kubernetes von der Storage-Landschaft. Controller-Plugin erzeugt und löscht. Node-Plugin mountet. Sidecars (provisioner, attacher, resizer, snapshotter) sind Pflichtbetrieb, kein Schmuck.
Ohne laufenden CSI-Treiber bleibt der Claim unbound. kubectl get csidriver und kubectl get pods -n kube-system auf den Treiber-Namespace sind die ersten zwei Befehle. Nicht kubectl delete pvc im Kreis.
Azure Disk, AWS EBS, GCE PD, vSphere, Longhorn, Ceph: verschiedene Provisioner-Namen, gleicher Vertrag. Die Klasse trägt den Provisioner-String. Ein Tippfehler dort erzeugt Events, keine Disk.
local-path (Rancher, kube-vip-Labs, viele Demos) ist ein Provisioner, der ein Verzeichnis auf dem Node anlegt. Das ist Kubernetes Persistent Storage im API-Sinn. Es ist kein replica-fähiger Speicher. Node weg, Daten weg. Im StatefulSet-Text sagen wir das ausführlich. Hier reicht der Satz: Default-Klasse local-path ist ein Test-Default, kein Prod-Default.
Pexon Consulting (Microsoft Partner, 30 Azure-Spezialisten) sieht denselben Fehler in AKS und on-prem: die Klasse heißt default, niemand weiß, welcher Treiber dahintersteht. kubectl get sc vor dem ersten Fachservice. Nicht danach.
Drei Befehle, bevor ihr den ersten Fach-Claim anlegt:
kubectl get sc
kubectl get csidriver
kubectl get pvc -A
Pending plus unbound immediate PersistentVolumeClaims heißt fast immer: keine Default-Klasse, falscher storageClassName, oder Immediate hat die Disk in der falschen Zone erzeugt. kubectl describe pvc shop-data -n shop zeigt den Provisioner-Fehler im Klartext. kubectl delete pvc im Kreis erzeugt neue Claims und dieselben Events.
Capacity ist eine Bestellung, kein Versprechen über IOPS. 20Gi auf einer langsamen HDD-Klasse bleibt langsam. Wer den Shop und die Datenbank auf dieselbe Klasse legt, weil nur eine existiert, kauft Nachbarn auf derselben Platte. Zwei Klassen sind der langweilige Mindeststand: eine für Tests (darf Delete sein), eine für Daten (Retain, WaitForFirstConsumer, Expansion an).
Wir raten davon ab, hostPath als stillen Ersatz für eine fehlende Klasse zu nutzen. hostPath umgeht den ganzen Vertrag. Der Pod klebt am Node, Backup sieht ihn nicht, der nächste Kollege findet die Daten nicht. Wenn der CSI-Treiber fehlt, ist das ein Cluster-Thema, kein YAML-Trick im Deployment.
Backup ist keine PVC-Annotation
Ein Claim speichert, er sichert nicht. VolumeSnapshot braucht CRDs, einen Snapshot-Controller und einen CSI-Treiber, der Snapshots kann. Das ist eine eigene Kette. Wir erwähnen sie, damit niemand reclaimPolicy: Retain mit Backup verwechselt.
Retain rettet euch vor dem versehentlichen kubectl delete pvc. Es ersetzt keinen Restore-Test. Snapshot ohne jemanden, der Restore übt, ist eine Datei, der ihr vertraut.
Diesen Text machen wir nicht zum Backup-Leitfaden. Wer Snapshots, Off-Cluster-Kopie und RPO braucht, braucht einen eigenen Schnitt. Hier bleibt der Hinweis: plant Backup, bevor der erste Rechnungslauf auf einem RWO-Volume liegt.
Was dieser Leitfaden auch nicht ist: ein Operator-Handbuch für Postgres. Identität, Headless Service, ein PVC pro Replica, das steht im StatefulSet-Text. Einsteiger brauchen zuerst den Claim-Vertrag. Erst danach das Set.
Resize nach oben geht, wenn Expansion an ist und der Treiber mitspielt. kubectl edit pvc auf 40Gi, dann warten. Dateisystem-Resize macht oft der Treiber im laufenden Pod. Nach unten geht fast nichts. Wer 2 Ti bestellt hat, weil die Folie groß wirkte, lebt mit der Rechnung.
Der Weg von der VM in den Container bleibt der Migrationsleitfaden. Stateful kommt dort zuletzt, Storage-Klassen sollten vorher stehen. Platform-Fragen (Golden Path, wer darf Klassen anlegen) gehören in die Platform-Engineering-Beratung, nicht in jedes YAML.
Häufig gestellte Fragen
Was kostet Kubernetes Persistent Storage on-prem?
Die API ist kostenlos. Geld sitzt in Disks, CSI-Betrieb, Snapshots und dem Tag, an dem Restore nicht geübt war. Wir setzen keinen Listenpreis in diesen Artikel. Der Einstieg ist ein Betriebsgespräch in 45 Minuten.
PV vs PVC: was ist der Unterschied?
PV ist clusterweit die Platte. PVC ist die Bestellung im Namespace. Dynamisch seht ihr das PV erst, nachdem der Claim die Klasse getroffen hat. Statisch legt ihr das PV zuerst an.
Kubernetes Persistent Storage mit ReadWriteOnce: können zwei Pods schreiben?
Auf demselben Node oft ja, auf zwei Nodes nein. Für zwei Schreiber braucht ihr RWX und ein Backend, das das kann. Block-Disk plus Wunsch ist Pending.
Ist local-path Production-Storage?
Für Demos ja. Für Daten, die ein Node-Verlust überleben sollen, nein. Dann CSI auf echte Disks oder ein Storage-System mit Replica.
Brauchen wir sofort VolumeSnapshots?
Nicht am ersten Tag. Wohl bevor Prod-Daten auf dem Volume liegen. Snapshot ohne Restore-Übung zählt für uns nicht.
Nächster Schritt
Verwandte Themen
→StatefulSet und local-path, ehrlich betrieben
→VMs zu Containern, Storage zuletzt



