使用PVC创建EBS卷时遇Invalid parameter key zone错误求助

你的错误是因为AWS EBS CSI驱动（ebs.csi.aws.com）不支持在StorageClass的parameters字段中直接设置zone参数——这个参数是旧版in-tree EBS provisioner（kubernetes.io/aws-ebs）的用法，CSI驱动使用拓扑约束来指定可用区，直接传递zone参数会导致EC2 CreateVolume API收到无效参数报错。

1. 修正StorageClass配置 #

移除parameters中的zone字段，改用allowedTopologies来指定目标可用区，示例配置如下：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: performance-aws-scratch-1
allowVolumeExpansion: false
provisioner: ebs.csi.aws.com
reclaimPolicy: Delete
volumeBindingMode: Immediate
parameters:
  csi.storage.k8s.io/fstype: ext4
  encrypted: "true"
  iopsPerGB: "1"
  type: io1
allowedTopologies:
- matchLabelExpressions:
  - key: topology.ebs.csi.aws.com/zone
    values:
    - us-east-1a

2. 应用修改并重建PVC #

• 执行命令更新StorageClass：

  kubectl apply -f <你的StorageClass配置文件路径>
  

• 删除原PVC并重新创建，让控制器使用修正后的StorageClass重新调度卷创建：

  kubectl delete pvc scratch0-0 -n aws-performance-ci-cd-pipeline
  # 重新创建PVC（根据你的PVC定义执行）
  kubectl apply -f <你的PVC配置文件路径>
  

可选优化：动态匹配Pod所在可用区 #

如果你的需求是让EBS卷和Pod处于同一可用区（避免跨区性能损耗），可以将volumeBindingMode改为WaitForFirstConsumer，这样CSI驱动会等待Pod调度完成后，在Pod所在的可用区自动创建卷，无需手动指定可用区：

volumeBindingMode: WaitForFirstConsumer

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