GKE Pod配置nodeAffinity+PV后持续处于ContainerCreating状态求助

问题现象 #

在单区域GKE集群（v1.21.14-gke.2700）中：

• 单独部署挂载PV/PVC的Pod，磁盘挂载正常
• 单独部署配置节点亲和、容忍度的Pod，调度正常
• 同时配置PV/PVC与节点亲和、容忍度的Pod持续处于ContainerCreating状态，报错：

  Unable to attach or mount volumes: unmounted volumes=[task-pv-storage], unattached volumes=[task-pv-storage kube-api-access-87dvb]: timed out waiting for the condition
  

核心原因 #

GCP持久化磁盘（PD）是区域级资源但绑定到特定可用区，单区域集群通常包含多个可用区。单独挂载PV/PVC时，调度器会自动将Pod调度到PD所在可用区的节点；但配置节点亲和规则后，调度器优先满足亲和要求，可能将Pod调度到与PD不同可用区的节点，而ReadWriteOnce模式的PV无法跨可用区挂载，最终导致挂载超时。

解决方案 #

需确保Pod调度节点与PD处于同一可用区，可通过以下两种方式实现：

方式1：修改Pod节点亲和规则，添加可用区匹配条件 #

GKE节点默认带有topology.kubernetes.io/zone标签，值为节点所在可用区。在节点亲和规则中增加该标签的匹配条件，强制Pod调度到PD所在可用区的节点。

修改后的Pod.yaml示例：

kind: Pod
apiVersion: v1
metadata:
  name: task-pv-pod
spec:
  volumes:
    - name: task-pv-storage
      persistentVolumeClaim:
       claimName: test-pvc
  containers:
    - name: task-pv-container
      image: nginx
      ports:
        - containerPort: 80
          name: "http-server"
      volumeMounts:
        - mountPath: "/usr/data"
          name: task-pv-storage
  affinity:
    nodeAffinity:
      requiredDuringSchedulingIgnoredDuringExecution:
        nodeSelectorTerms:
        - matchExpressions:
          - key: xxx
            operator: In
            values:
            - xxxxx
          # 替换为你的PD所在可用区
          - key: topology.kubernetes.io/zone
            operator: In
            values:
            - us-central1-a
  tolerations:
  - key: "xxx"
    operator: "Equal"
    value: "xxxxx"

方式2：启用拓扑感知卷绑定 #

开启该特性后，调度器会同时协调Pod亲和规则与PV的拓扑限制，确保Pod调度到可挂载PV的节点上。GKE v1.21及以上版本默认开启该特性，若未开启可按以下步骤配置：

1. 编辑默认存储类：

   kubectl edit storageclass standard
   

2. 更新配置，确保volumeBindingMode为WaitForFirstConsumer，并指定集群可用区：

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: standard
   provisioner: kubernetes.io/gce-pd
   parameters:
     type: pd-standard
   volumeBindingMode: WaitForFirstConsumer
   allowedTopologies:
   - matchLabelExpressions:
     - key: topology.kubernetes.io/zone
       values:
       - us-central1-a
       - us-central1-b
       - us-central1-c
   

3. 重新创建PV/PVC和Pod，调度器会自动匹配拓扑进行调度。

验证步骤 #

1. 在GCP控制台查看PD的可用区并记录
2. 部署修改后的Pod，查看调度节点：

   kubectl get pod task-pv-pod -o wide
   

3. 检查节点的可用区标签：

   kubectl get node <节点名称> -o jsonpath='{.metadata.labels.topology\.kubernetes\.io/zone}'
   

4. 确认节点可用区与PD一致，此时Pod应正常进入Running状态

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