Kubernetes无法挂载vSphere VSAN磁盘至Pod问题求助

我之前在vSphere环境里用Kubespray部署K8s时碰到过类似的VSAN挂载问题，给你梳理几个实用的排查方向和解决办法：

1. 先确认节点的VMware工具状态 #

VSAN磁盘的挂载依赖VMware Tools，CentOS7上一定要确保open-vm-tools是正常运行的：

• 检查状态：systemctl status open-vm-tools
• 如果未安装：yum install open-vm-tools -y && systemctl enable --now open-vm-tools
  要是工具没跑起来，kubelet根本没法和vSphere交互操作磁盘。

2. 核对StorageClass和PV的配置细节 #

• StorageClass：要确保provisioner是kubernetes.io/vsphere-volume，同时指定正确的VSAN datastore和磁盘格式，比如：

  kind: StorageClass
  apiVersion: storage.k8s.io/v1
  metadata:
    name: vsan-storage
  provisioner: kubernetes.io/vsphere-volume
  parameters:
    diskformat: thin  # VSAN支持thin/thick/eagerZeroedThick
    datastore: VSAN-Cluster-Datastore  # 这里填你的VSAN datastore名称
  

• PV/PVC：如果是静态PV，要确认vsphereVolume.volumePath的格式正确，应该是[VSAN-Datastore] 虚拟机名称/磁盘文件名.vmdk，别写错datastore或者磁盘路径。

3. 检查kubelet的云提供商配置 #

Kubespray部署时，要确保节点的kubelet已经启用vSphere云提供商支持：

• 查看kubelet启动参数，确认有--cloud-provider=vsphere
• 检查云配置文件/etc/kubernetes/cloud-config，里面要正确配置vCenter的地址、用户名、密码，而且这个账号必须有访问VSAN datastore、创建/挂载磁盘的权限。
  可以用govc工具快速验证权限：

govc login -u your-vcenter-user@vsphere.local -p your-password vcenter.example.com
govc datastore.ls VSAN-Cluster-Datastore  # 能列出内容说明权限没问题

4. 查看kubelet的详细日志找根因 #

事件里的FailedMount只是表面现象，得看kubelet的具体错误日志：

journalctl -u kubelet -f | grep -i "mount\|volume\|vsphere"

常见的错误比如：

• 找不到指定的VSAN datastore
• vCenter账号权限不足
• VMware Tools未安装导致无法识别磁盘
• PV对应的磁盘已经被其他虚拟机占用

5. 检查VSAN存储本身的健康状态 #

登录vCenter后台：

• 确认VSAN集群状态正常，没有磁盘故障或者性能告警
• 检查要挂载的磁盘是否存在，有没有被锁定
• 确认VSAN存储策略是否符合要求（比如冗余级别、IOPS限制），避免因为策略不匹配导致无法挂载

6. 注意K8s 1.9.5的兼容性问题 #

这个版本比较老旧，要确保你的vSphere版本是6.0及以上（推荐6.5+），K8s 1.9对vSphere的兼容性有限，太老的vSphere版本可能会出现插件交互问题。另外，Kubespray部署时要确保已经开启了vSphere云提供商的配置项（inventory文件里设置cloud_provider: vsphere）。

先从kubelet日志入手定位具体错误，再对应上面的方向排查，应该能解决问题。

内容的提问来源于stack exchange，提问作者schlussbilanz