STO-001.md

STO-001 PV config or backing storage issue

Summary

A PV in Failed phase usually indicates misconfiguration or that the backing storage (e.g. NFS, cloud disk) is unavailable or has permission issues, preventing mount or use.

Severity

Warning

Example

N/A

Symptoms

• Report shows: Persistent Volume <name> is in Failed state
• PV status.phase is Failed

Resolution

1. Inspect PV: kubectl describe pv <name> and check Events, Capacity, StorageClass
2. Verify backing storage: NFS path accessibility, cloud disk attachment, permissions and network
3. For static PVs, confirm volume config (hostPath, NFS, etc.) and node state
4. If unrecoverable, delete and recreate PV/PVC after backing up data and considering reclaim policy

References

• Persistent Volumes
• Debug storage