自建Kubernetes集群中gcePersistentDisk无法挂载求助

嘿，我碰到过好几次自建K8s集群用GCE PD挂载失败的情况，尤其是和GKE不同，自建集群很多自动处理的环节得手动搞定。结合你的配置和问题描述，咱们一步步来排查：

先搞定最基础的节点权限问题 #

自建K8s节点的VM实例必须有操作GCE磁盘的权限，这是最容易踩的坑：

• 给节点VM的服务账号加上roles/compute.storageAdmin或者roles/compute.instanceAdmin.v1权限，不然节点根本没资格挂载GCE PD
• 检查节点VM的访问范围（scopes），必须包含https://www.googleapis.com/auth/compute——如果创建VM时没选，得去GCP控制台修改VM的scope

你的配置里藏着几个冲突点 #

看了你的部署文件，有几个明显的问题可能导致挂载失败：

1. PV、PVC和Deployment直接挂载的混合使用 #

你同时定义了手动PV、PVC，还在Deployment里直接引用GCE磁盘，这会让K8s搞不清该用哪个路径。建议二选一：要么用PV+PVC的规范方式，要么直接在Pod里挂载磁盘，别混着来。

2. StorageClass的依赖没满足 #

你用的kubernetes.io/gce-pd provisioner在自建集群里不是开箱即用的：

• 必须部署云控制器管理器（cloud-controller-manager），而且要配置好GCP的认证信息——这个组件是K8s和GCP API交互的关键，没有它，StorageClass根本没法自动创建磁盘（哪怕你手动建PV，也可能因为这个出问题）
• 如果你是手动创建PV，其实可以不用StorageClass，或者确保PV的storageClassName和PVC完全一致，同时确认你的nfs-disk确实是pd-ssd类型

3. 再确认可用区完全匹配 #

虽然你说都在同一可用区，但还是要再核对一遍：

• 运行Pod的节点VM和nfs-disk必须在完全相同的可用区（比如us-central1-a，差一个字母都不行）
• 用gcloud compute disks describe nfs-disk --zone=<你的可用区>检查磁盘状态，确保它是READY状态，没有被其他VM占用

给你两个修复方案 #

方案1：简化配置（适合快速测试） #

去掉PV和PVC，直接在Deployment里挂载磁盘，配置如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: apache-service
spec:
  selector:
    matchLabels:
      app: apache
  replicas: 1
  template:
    metadata:
      labels:
        app: apache
    spec:
      volumes:
        - name: service-pv-storage
          gcePersistentDisk:
            pdName: nfs-disk
            fsType: ext4
            readOnly: false # 明确指定可读写，避免默认值问题
      containers:
        - name: apache
          image: mobingi/ubuntu-apache2-php7:7.2
          ports:
            - containerPort: 80
          volumeMounts:
            - mountPath: "/var/www/html"
              name: service-pv-storage

方案2：用PV+PVC规范挂载（生产环境推荐） #

1. 先修正PV配置，确保和PVC绑定：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: nfs-pv
spec:
  storageClassName: ssd-sc
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteOnce
  gcePersistentDisk:
    pdName: nfs-disk
    fsType: ext4
  claimRef: # 直接绑定到你的PVC，避免调度问题
    name: nfs-pvc
    namespace: default

2. 保持PVC不变，修改Deployment通过PVC挂载：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: apache-service
spec:
  selector:
    matchLabels:
      app: apache
  replicas: 1
  template:
    metadata:
      labels:
        app: apache
    spec:
      volumes:
        - name: service-pv-storage
          persistentVolumeClaim:
            claimName: nfs-pvc
      containers:
        - name: apache
          image: mobingi/ubuntu-apache2-php7:7.2
          ports:
            - containerPort: 80
          volumeMounts:
            - mountPath: "/var/www/html"
              name: service-pv-storage

最后，用这些命令排查具体错误 #

如果还是失败，别慌，用这些命令找问题：

• 查看Pod的事件日志：kubectl describe pod <你的apache-pod名称>，Events里会详细说明挂载失败的原因（比如权限不够、磁盘不存在）
• 查看节点的kubelet日志：journalctl -u kubelet -f（systemd节点），看kubelet处理磁盘挂载的详细过程
• 手动在节点上挂载磁盘测试：

  lsblk # 找到磁盘设备，一般是/dev/sdb
  mkdir /tmp/test-mount
  mount /dev/sdb /tmp/test-mount # 能挂载说明磁盘本身没问题，问题在K8s配置
  umount /tmp/test-mount # 测试完记得卸载
  

内容的提问来源于stack exchange，提问作者Harpartap Singh Permar