EKS v1.16中Jenkins Pod报Invalid Volume Zone mismatch错误如何修复

问题原因 #

AWS EBS是可用区（AZ）级别的存储资源，不支持跨可用区挂载到节点。你手动创建的PV绑定的EBS卷固定位于us-east-2b可用区，但PV未配置对应的拓扑亲和性规则，Kubernetes调度器无法感知该PV的可用区限制，会将Jenkins Pod随机调度到集群其他可用区的节点，最终导致EBS卷挂载失败、Pod无法正常运行。

修复方案 #

你可以任选以下任意一种方案解决，两种方案同时配置冗余性更高：

方案1：为PV添加节点亲和性规则（推荐） #

直接修改现有PV配置，添加可用区亲和性限制，调度器会自动识别该规则，将关联的Pod调度到对应可用区的节点：

1. 执行命令编辑PV：

kubectl edit pv jenkins-vol

2. 在spec字段下添加如下nodeAffinity配置（EKS 1.16版本使用beta版拓扑标签）：

spec:
  # 原有其他配置保持不变
  nodeAffinity:
    required:
      nodeSelectorTerms:
      - matchExpressions:
        - key: failure-domain.beta.kubernetes.io/zone
          operator: In
          values:
          - us-east-2b

3. 保存退出即可，PV无需重建，配置会立即生效。

方案2：为Jenkins工作负载添加节点选择器 #

直接限制Jenkins Pod只能调度到us-east-2b可用区的节点：

1. 如果你是用Helm部署的Jenkins，修改values.yaml中的nodeSelector配置：

nodeSelector:
  failure-domain.beta.kubernetes.io/zone: us-east-2b

2. 执行helm upgrade命令更新配置即可。如果没有用Helm管理，直接编辑Jenkins的Deployment/StatefulSet添加上述nodeSelector配置即可。

验证 #

配置完成后删除原有运行异常的Jenkins Pod，等待新Pod调度完成，执行kubectl describe pod <jenkins-pod-name> -n ci查看Node字段对应的可用区，确认调度到us-east-2b可用区的节点、EBS卷正常挂载即可。

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