Kubernetes动态卷配置异常：Pod存在未绑定的即时PersistentVolumeClaims

尝试为Pod配置动态卷功能，集群中Pod处于Pending状态，报错：pod has unbound immediate PersistentVolumeClaims。操作步骤如下：

1. 创建StorageClass：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: fast
provisioner: kubernetes.io/gce-pd
parameters:
  type: pd-ssd
reclaimPolicy: Retain
allowVolumeExpansion: true
volumeBindingMode: WaitForFirstConsumer   

2. 创建两个PersistentVolume：

kind: PersistentVolume
apiVersion: v1
metadata:
  name: postgres-01
  labels:
    type: pd-ssd
spec:
  storageClassName: fast
  capacity:
    storage: 300Mi
  accessModes:
    - ReadWriteMany
  hostPath:
    path: "/path/to/somelocaldirectory"

kind: PersistentVolume
apiVersion: v1
metadata:
  name: postgres-02
  labels:
    type: pd-ssd
spec:
  storageClassName: fast
  capacity:
    storage: 300Mi
  accessModes:
    - ReadWriteMany
  hostPath:
    path: "/path/to/somelocaldirectory"

3. Postgres Pod配置片段：

volumes:
  - name: postgres-conf
    configMap:
      name: confpostgres
volumeClaimTemplates:
- metadata:
    name: postgresdata
  spec:
    accessModes: [ "ReadWriteMany" ]
    storageClassName: fast
    resources:
      requests:
        storage: 300Mi

核心矛盾点 #

1. StorageClass与手动PV类型不匹配：你定义的fast StorageClass用于动态创建GCE云磁盘，但手动创建的PV用了节点本地的hostPath，两者存储类型完全不同，导致PVC无法匹配到合适的PV。
2. WaitForFirstConsumer绑定模式的限制：该模式下PVC会等待Pod调度到节点后再绑定PV，但hostPath PV仅能在创建它的节点上使用，如果Pod被调度到其他节点，PVC找不到可用PV。
3. ReadWriteMany访问模式误用：hostPath属于节点本地存储，不支持真正的多节点读写（ReadWriteMany），只有NFS、GlusterFS等共享存储才能实现该模式。

解决方案 #

方案一：使用StorageClass动态供应GCE磁盘（推荐） #

既然已经定义了基于GCE-PD的StorageClass，直接利用动态供应功能即可，无需手动创建PV：

1. 删除手动创建的hostPath类型PV：

kubectl delete pv postgres-01 postgres-02

2. 确保集群运行在GCE环境（如GKE），节点默认具备创建GCE磁盘的权限。
3. 重新部署Postgres Pod，StorageClass会自动为volumeClaimTemplates创建匹配的GCE SSD磁盘PV，并完成绑定。

方案二：调整手动PV适配测试需求（仅适合测试环境） #

如果必须使用hostPath，需修改以下配置：

1. 修正PV和PVC的访问模式：将PV和volumeClaimTemplates中的accessModes改为ReadWriteOnce（单节点读写）：
   • PV配置修改：

   accessModes:
     - ReadWriteOnce
   

   • PVC配置修改：

   accessModes: [ "ReadWriteOnce" ]
   

2. 强制Pod调度到PV所在节点：给PV所在节点打标签，再给Pod添加节点选择器：
   • 给节点打标签：

   kubectl label nodes <目标节点名称> local-storage=enabled
   

   • 在Pod模板中添加节点选择器：

   spec:
     nodeSelector:
       local-storage: enabled
   

3. 重新创建PV和Pod，PVC会在Pod调度到目标节点后完成绑定。

方案三：修改StorageClass绑定模式 #

如果不需要等待Pod调度再绑定PV，可将StorageClass的volumeBindingMode改为Immediate：

volumeBindingMode: Immediate

修改后重新应用StorageClass，PVC会立即尝试匹配符合条件的PV，但仍需解决hostPath PV的节点限制问题。

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