ExitStatus32 kubernetes runtime_error ai_generated true

MountVolume.SetUp failed for volume "pvc-xxx" : rpc error: code = Internal desc = rpc error: code = Internal desc = mount failed: exit status 32

ID: kubernetes/failed-to-mount-volume

Also available as: JSON · Markdown · 中文
80%Fix Rate
85%Confidence
1Evidence
2024-03-10First Seen

Root Cause

The CSI driver or node filesystem fails to mount the persistent volume, often due to incorrect filesystem type, corrupted disk, or missing mount utilities on the node.

generic

中文

CSI 驱动程序或节点文件系统无法挂载持久卷，通常是由于文件系统类型不正确、磁盘损坏或节点上缺少挂载工具。

Official Documentation

https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-errors

Workarounds

  1. 75% success Check the node's filesystem and repair it: ssh to the node and run 'sudo fsck -y /dev/<device>' or 'sudo xfs_repair /dev/<device>' if using XFS. 
    Check the node's filesystem and repair it: ssh to the node and run 'sudo fsck -y /dev/<device>' or 'sudo xfs_repair /dev/<device>' if using XFS.
  2. 85% success Ensure the 'nfs-common' or 'cifs-utils' package is installed on the node: 'sudo apt-get install -y nfs-common' for NFS volumes. 
    Ensure the 'nfs-common' or 'cifs-utils' package is installed on the node: 'sudo apt-get install -y nfs-common' for NFS volumes.

中文步骤

  1. Check the node's filesystem and repair it: ssh to the node and run 'sudo fsck -y /dev/<device>' or 'sudo xfs_repair /dev/<device>' if using XFS.
  2. Ensure the 'nfs-common' or 'cifs-utils' package is installed on the node: 'sudo apt-get install -y nfs-common' for NFS volumes.

Dead Ends

Common approaches that don't work:

  1. Restart the kubelet service on the node 80% fail

    Kubelet restart doesn't repair underlying filesystem issues or CSI driver bugs; the mount operation still fails.

  2. Delete and recreate the PersistentVolumeClaim 70% fail

    The PVC is bound to a specific PV; recreating it doesn't fix the node-level mount failure unless the underlying volume is repaired.