Не удаляйте 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 Pending | Provisioning/binding | StorageClass, provisioner, capacity, accessModes |
| Pod Pending: volume node affinity conflict | Scheduler/topology | PV nodeAffinity и node labels |
| FailedAttachVolume / Multi-Attach | CSI controller/cloud | Старый node attachment и access mode |
| FailedMount | Kubelet/node | CSI node plugin, fsType, mount options, secret |
| Pod Running, путь пуст | volumeMount/app | claimName, 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 и содержимое пользовательских данных исключите.