Не удаляйте PVC, чтобы «создался заново», пока не знаете reclaim policy и где лежат данные. Сначала найдите этап сбоя: PVC ещё Pending, Pod не планируется на node, CSI не прикрепляет диск или kubelet не монтирует filesystem. Сообщения Events у этих этапов разные и ведут к разным действиям.

Связка читается от Pod: имя claim → PVC `.spec.volumeName` → PV → StorageClass/CSI volume handle. Сохраните этот набор и zone/node до вмешательства. Новый Pod с тем же claim не исправит несовместимую topology, а параллельный Pod может добавить Multi-Attach конфликт.

Фаза и событие определяют владельца проблемы

СимптомСлойЧто смотреть
PVC PendingProvisioning/bindingStorageClass, provisioner, capacity, accessModes
Pod Pending: volume node affinity conflictScheduler/topologyPV nodeAffinity и node labels
FailedAttachVolume / Multi-AttachCSI controller/cloudСтарый node attachment и access mode
FailedMountKubelet/nodeCSI node plugin, fsType, mount options, secret
Pod Running, путь пустvolumeMount/appclaimName, mountPath, subPath, volumeMode

События стареют и агрегируются, поэтому снимайте их вместе с timestamp. Логи CSI controller нужны для attach/provision, CSI node plugin и kubelet — для mount. Общий лог приложения на этом этапе обычно ничего не добавляет.

Минимальный срез собирается read-only командами

NS=example
POD=app-0
PVC=data-app-0

kubectl -n "$NS" describe pod "$POD"
kubectl -n "$NS" get pvc "$PVC" -o yaml
kubectl get pv "$(kubectl -n "$NS" get pvc "$PVC" -o jsonpath={.spec.volumeName})" -o yaml
kubectl get storageclass -o yaml

Перед запуском проверьте kube-context и замените условные имена. Команды ничего не меняют. В диагностическом архиве замаскируйте секреты и provider volume handle, если он считается чувствительным внутренним идентификатором.

Pending PVC объясняют класс и режим binding

PVC сопоставляется с PV по StorageClass, capacity, volumeMode и access modes. При dynamic provisioning проверьте provisioner и события claim. `WaitForFirstConsumer` откладывает создание/выбор volume до появления Pod, чтобы учесть его node selector, affinity, taints и topology. При этом явный `nodeName` обходит scheduler и может оставить PVC в Pending.

  • Пустой `storageClassName` и отсутствующее поле имеют разный смысл при наличии default class.
  • Запрошенный размер не должен превышать подходящие available volumes при static provisioning.
  • Filesystem и Block требуют разного использования в Pod spec.
  • Allowed topology класса и zone доступных nodes должны пересекаться.
  • Provisioner/CSI sidecars должны быть готовы и иметь разрешения.

Bound ещё не означает, что диск можно прикрепить здесь

PV может ограничивать nodes через node affinity. Pod с таким PV планируется только на подходящий node. Для zonal disk перенос Pod в другую zone не делает данные доступными автоматически. Сначала сравните PV topology labels с node labels и политикой scheduler; не редактируйте affinity существующего диска без подтверждённой миграции storage.

`ReadWriteOnce` означает read-write mount одним node и всё ещё может допускать несколько Pods на том же node. Для строгого одного Pod существует `ReadWriteOncePod` при поддерживаемом CSI. Ошибка Multi-Attach часто означает, что старый Pod/node attachment ещё не освобождён, а не что claim нужно удалить.

Attach и mount устраняются в правильном порядке

При attach ошибке проверьте состояние node, VolumeAttachment и облачного диска; принудительное detach опасно для работающего writer. При mount ошибке сравните fsType, mountOptions, наличие CSI node plugin и credentials. Повреждение filesystem диагностируется по процедуре storage-провайдера на остановленном writer, а не случайным `fsck` внутри нового Pod.

Восстановление доказывает сохранность данных

После исправления Pod должен пройти Scheduled, Attach и Mount без новых warning Events. Выполните безопасное чтение контрольного файла или прикладной health check; запись делайте только если приложение допускает её. Затем пересоздайте один Pod и убедитесь, что volume повторно монтируется и данные сохраняются.

Для разбора подготовьте describe Pod/PVC/PV, StorageClass, Events, версии Kubernetes и CSI driver, node/zone labels и ожидаемый access pattern. YAML Secrets, kubeconfig, cloud credentials и содержимое пользовательских данных исключите.

Проверенные источники