Autor: [Piotr Wasilewski](/autorzy/piotr-wasilewski) Architekt rozwiązań chmurowych · Zweryfikowano Kwiecień 2026 1. [Strona główna](/) › 2. [Baza wiedzy](/baza-wiedzy/) › 3. Kubernetes PersistentVolume — storage # Kubernetes PersistentVolume — zarządzanie storage w klastrze Opublikowano: 10 kwietnia 2026 · Kategoria: VPS / Kubernetes Pody Kubernetes są efemeryczne — giną i odradzają się, tracąc dane zapisane wewnątrz kontenera. PersistentVolume to mechanizm K8s, który oddziela cykl życia danych od cyklu życia poda. Ten artykuł wyjaśnia cały model storage w K8s: PV jako zasób, PVC jako żądanie, StorageClass jako fabrykę PV, różne access modes, jak prawidłowo skonfigurować NFS jako backend oraz jak robić backupy z Velero. ## Lifecycle PV i PVC — jak działa binding Przepływ statycznego provisioningu (admin tworzy PV ręcznie): \# 1. Admin tworzy PV (statyczny) apiVersion: v1 kind: PersistentVolume metadata: name: nfs-pv-prod spec: capacity: storage: 50Gi accessModes: - ReadWriteMany # NFS obsługuje RWX persistentVolumeReclaimPolicy: Retain storageClassName: nfs-slow # matchuje z PVC storageClassName nfs: server: 192.168.1.100 path: /exports/k8s-data --- # 2. Uzytkownik tworzy PVC apiVersion: v1 kind: PersistentVolumeClaim metadata: name: app-storage namespace: production spec: accessModes: - ReadWriteMany storageClassName: nfs-slow resources: requests: storage: 10Gi # K8s znajdzie PV z min 10Gi w tej StorageClass --- # 3. Pod montuje PVC apiVersion: v1 kind: Pod spec: containers: - name: app image: nginx volumeMounts: - name: data mountPath: /var/data volumes: - name: data persistentVolumeClaim: claimName: app-storage \# Sprawdzenie statusu kubectl get pv # NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM # nfs-pv-prod 50Gi RWX Retain Bound production/app-storage kubectl get pvc -n production # NAME STATUS VOLUME CAPACITY ACCESS MODES # app-storage Bound nfs-pv-prod 50Gi RWX ## StorageClass — dynamiczne provisioning Dynamiczny provisioning eliminuje ręczne tworzenie PV — K8s robi to automatycznie po stworzeniu PVC. StorageClass definiuje jaki storage i z jakimi parametrami: \# StorageClass dla Longhorn (on-prem distributed storage) apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: longhorn-ssd annotations: storageclass.kubernetes.io/is-default-class: "true" # domyslna klasa provisioner: driver.longhorn.io parameters: numberOfReplicas: "3" # replikacja danych na 3 wezlach staleReplicaTimeout: "30" diskSelector: "ssd" # tylko dyski oznaczone jako SSD reclaimPolicy: Retain # zachowaj dane po usunieciu PVC! allowVolumeExpansion: true # pozwol na resize PVC volumeBindingMode: WaitForFirstConsumer # poczekaj az pod zostanie zaschedulowany --- # StorageClass dla NFS (CSI Driver) apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: nfs-csi provisioner: nfs.csi.k8s.io parameters: server: 192.168.1.100 share: /exports/k8s reclaimPolicy: Delete mountOptions: - hard - nfsvers=4.1 --- # StorageClass dla local storage (pin pod do wezla z dyskiem) apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: local-ssd provisioner: kubernetes.io/no-provisioner # brak dynamicznego prov. volumeBindingMode: WaitForFirstConsumer # WYMAGANE dla local reclaimPolicy: Retain ## Porównanie backendów storage Backend Access Modes Latency Replikacja Snapshots Kiedy używać Local storage RWO Najniższa Nie Nie Dev, stateless, bazy z własną replikacją NFS RWO, ROX, RWX Sieciowa Nie (serwer) Nie Współdzielone pliki, CMS, uploads Longhorn RWO, RWX\* Sieciowa Tak (2-3) Tak On-prem produkcja, mały klaster Ceph/Rook RWO, ROX, RWX Sieciowa Tak (3+) Tak Duży on-prem klaster, enterprise AWS EBS CSI RWO Niska (gp3) Tak (AZ) Tak AWS EKS, produkcja chmurowa ## Resize PVC — zwiększanie rozmiaru \# Sprawdz czy StorageClass obsługuje resize kubectl get storageclass longhorn-ssd -o jsonpath='{.allowVolumeExpansion}' # true — OK, mozna resizowac # Zwieksz PVC z 10Gi do 50Gi (edit spec.resources.requests.storage) kubectl patch pvc app-storage -n production \\ -p '{"spec":{"resources":{"requests":{"storage":"50Gi"}}}}' # Monitoruj status resizu kubectl describe pvc app-storage -n production # Events: # Warning ExternalExpanding Waiting for volume controller to expand volume # Normal Resizing External resizer is resizing volume # Normal FileSystemResizeRequired Require file system resize of volume # Dla niektorych CSI wymagany restart poda (zeby OS zmienilo rozmiar FS) kubectl rollout restart deployment my-app -n production # Weryfikacja po resizu kubectl exec -n production deploy/my-app -- df -h /var/data ## Backup z Velero — snapshots PV i manifesty K8s \# Instalacja Velero z backendem Backblaze B2 / S3-compatible velero install \\ --provider aws \\ --plugins velero/velero-plugin-for-aws:v1.9.0 \\ --bucket velero-backups \\ --secret-file ./credentials-velero \\ --backup-location-config region=us-east-1,s3Url=https://s3.eu-central-003.backblazeb2.com,s3ForcePathStyle=true \\ --snapshot-location-config region=eu-central-1 \\ --use-volume-snapshots=true # Jednorazowy backup całego namespace velero backup create production-backup \\ --include-namespaces=production \\ --wait # Harmonogram codziennych backupow velero schedule create daily-backup \\ --schedule="0 2 \* \* \*" \\ --include-namespaces=production \\ --ttl 720h0m0s # przechowuj 30 dni # Restore namespace velero restore create --from-backup production-backup # Status backupow velero backup get velero backup describe production-backup --details ## Najczęstsze pytania Czym różni się PV, PVC i StorageClass w Kubernetes? + PersistentVolume (PV) to fizyczne zasoby storage — np. wolumin EBS, katalog NFS, dysk lokalny. Są tworzone przez admina lub dynamicznie przez StorageClass. PersistentVolumeClaim (PVC) to żądanie zasobów przez użytkownika — "potrzebuję 10 GB RWO". K8s matchuje PVC z odpowiednim PV (binding). StorageClass to szablon do dynamicznego tworzenia PV: definiuje provisioner (np. aws-ebs, nfs.csi.k8s.io), parametry (typ dysku, IOPS) i reclaim policy. Dynamiczne provisioning przez StorageClass eliminuje konieczność ręcznego tworzenia PV przez admina. Jakie są tryby dostępu PersistentVolume? + Kubernetes definiuje trzy access modes: ReadWriteOnce (RWO) — wolumin może być zamontowany przez jeden węzeł jednocześnie w trybie do odczytu i zapisu (typowe dla baz danych). ReadOnlyMany (ROX) — wiele węzłów może montować wolumen tylko do odczytu (statyczne pliki). ReadWriteMany (RWX) — wiele węzłów może montować do zapisu i odczytu jednocześnie (wymaga NFS, CephFS, AzureFile, GlusterFS — EBS i local storage NIE obsługują RWX). Wybór access mode musi pasować do możliwości konkretnego storage backend. Co się dzieje z PV po usunięciu PVC? + To zależy od Reclaim Policy: Delete (domyślne dla dynamicznie tworzonych PV) — po usunięciu PVC, PV i dane są usuwane automatycznie. Uwaga: może to oznaczać utratę danych. Retain — po usunięciu PVC, PV pozostaje w stanie Released (nie może być ponownie zbindowany) — dane są zachowane, administrator musi ręcznie wyczyścić i zbindować PV ponownie. Recycle (deprecated) — czyściło dane i udostępniało PV ponownie. Dla produkcji zawsze używaj Retain lub backup danych przed usunięciem PVC. Jak zwiększyć rozmiar PVC w Kubernetes? + Resize PVC wymaga: (1) StorageClass z allowVolumeExpansion: true, (2) CSI drivera który obsługuje resize. Proces: kubectl patch pvc moja-pvc -p '{"spec":{"resources":{"requests":{"storage":"50Gi"}}}}'. Dla wielu providerów (EBS, GCE PD) resize jest online — bez restartu poda. Dla lokalnych wolumenów może być wymagany restart poda żeby filesystem dobrał nowy rozmiar. Sprawdź status przez kubectl describe pvc moja-pvc i szukaj eventów FileSystemResizePending. ## Sprawdź oferty pasujące do tego scenariusza Poniżej masz szybkie przejścia do ofert i stron z kodami rabatowymi tam, gdzie są dostępne. Contabo VPS z dużym dyskiem NVMe — idealny backend dla K8s PersistentVolumes K8s Storage [Aktywuj rabat →](/out/contabo) #Reklama · link partnerski [Zobacz kod rabatowy →](/kody-rabatowe/contabo) ProSerwer.pl Polski VPS z SSD — trwały storage dla aplikacji Kubernetes Polski VPS [Aktywuj rabat →](/out/proserwer-pl) #Reklama · link partnerski [Zobacz kod rabatowy →](/kody-rabatowe/proserwer) Mikr.us Tani VPS do nauki K8s PVC i StorageClass w praktyce Dev/Test [Aktywuj rabat →](/out/mikrus) #Reklama · link partnerski [Zobacz kod rabatowy →](/kody-rabatowe/mikrus) ## Powiązane strony - [Kubernetes StatefulSet — bazy danych](/baza-wiedzy/kubernetes-statefulset-bazy-danych) - [k3s — lekki Kubernetes na VPS](/baza-wiedzy/kubernetes-k3s-vps) - [rsync — kopia zapasowa VPS](/baza-wiedzy/rsync-kopia-zapasowa-vps) - [Wszystkie artykuły](/baza-wiedzy/)