Как исправить PersistentVolumeClaim pending в Kubernetes

Что такое PersistentVolumeClaim pending?

Ошибка PersistentVolumeClaim pending возникает, когда Kubernetes не может привязать PVC к доступному PersistentVolume.

Причины возникновения

Нет доступных PersistentVolume
Несоответствие StorageClass
Недостаточно места на storage
Проблемы с правами доступа
Неправильная конфигурация StorageClass
Проблемы с CSI driver

Как отладить ошибку

Проверь PVC - kubectl get pvc
Проверь PV - kubectl get pv
Проверь StorageClass - kubectl get storageclass
Проверь события - kubectl describe pvc pvc-name
Проверь storage capacity - kubectl top nodes

Как исправить ошибку

1. Создай PersistentVolume

apiVersion: v1
kind: PersistentVolume
metadata:
  name: my-pv
spec:
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteOnce
  persistentVolumeReclaimPolicy: Retain
  storageClassName: local-storage
  local:
    path: /mnt/data
  nodeAffinity:
    required:
      nodeSelectorTerms:
      - matchExpressions:
        - key: kubernetes.io/hostname
          operator: In
          values:
          - node-1

2. Настрой StorageClass

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: fast-ssd
provisioner: kubernetes.io/aws-ebs
parameters:
  type: gp2
  iops: "3000"
volumeBindingMode: WaitForFirstConsumer
allowVolumeExpansion: true

3. Создай PVC с правильными параметрами

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-pvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: fast-ssd
  resources:
    requests:
      storage: 10Gi

4. Используй динамическое provisioning

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-pvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: managed-premium  # Azure Premium Storage
  resources:
    requests:
      storage: 10Gi

5. Проверь и исправь права доступа

# Проверь права на storage
ls -la /mnt/data

# Измени права если нужно
chmod 755 /mnt/data
chown 1000:1000 /mnt/data

# Проверь SELinux контекст
ls -Z /mnt/data

6. Используй volume в Pod

apiVersion: v1
kind: Pod
metadata:
  name: my-app
spec:
  containers:
  - name: app
    image: nginx:latest
    volumeMounts:
    - name: data-volume
      mountPath: /data
  volumes:
  - name: data-volume
    persistentVolumeClaim:
      claimName: my-pvc

Как мониторить подобные ошибки

Мониторь доступность storage
Настрой алерты на pending PVC
Проверяй capacity storage
Логируй события storage

FAQ

В: Что делать, если нет доступных PV?

О: Создай новые PV или настрой динамическое provisioning через StorageClass.

В: Как выбрать правильный StorageClass?

О: Учитывай требования к производительности, доступности и стоимости.

В: Что делать с проблемами CSI driver?

О: Проверь установку CSI driver, логи и совместимость версий.

Лучшие практики

Используй StorageClass для динамического provisioning
Планируй capacity заранее
Настрой backup стратегии
Мониторь использование storage
Документируй storage требования