在GKE自动配置的PersistentVolumeClaim中使用自定义卷名称

默认GKE的标准存储类自动置备逻辑不支持完全自定义pvc-开头的PV/对应GCE磁盘的完整名称，你之前尝试设置spec.volumeName失效是正常情况：该字段的作用是指定PVC需要绑定的已存在PV的名称，填写后K8s会跳过自动置备流程，直接查找匹配名称的PV，找不到就会绑定失败，自然无法自动创建存储卷。

你可以通过以下几种方案实现GCE控制台磁盘快速识别的需求：

方案一：给PVC添加标签/注解（最便捷，保留自动置备能力） #

GKE自动置备的GCE磁盘会自动继承PVC的元数据标签和注解，你只需在PVC的metadata字段中添加自定义标识即可，这些内容会直接展示在GCE磁盘控制台的详情页，也支持按标签筛选磁盘，示例配置如下：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-test-pvc1
  # 自定义标签，可用于控制台筛选
  labels:
    app: user-service
    env: production
    usage: user-avatar-storage
  # 自定义描述注解，直接展示磁盘用途
  annotations:
    disk-description: "存储生产环境用户服务的头像、附件数据"
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: standard-rwo
  resources:
    requests:
      storage: 10Gi

方案二：自定义存储类添加磁盘名称前缀（兼顾辨识度与自动置备能力） #

如果你希望磁盘名称本身就携带业务标识，可以基于GKE的PD CSI驱动自定义存储类，通过volumeNamePrefix参数设置统一的磁盘名称前缀，自动生成的磁盘会以你指定的前缀开头，示例配置如下：

1. 先创建自定义存储类：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: biz-pd-standard
provisioner: pd.csi.storage.gke.io
parameters:
  type: pd-standard
  # 自定义磁盘名称前缀，最多支持20个字符
  volumeNamePrefix: "prod-user-svc-"
reclaimPolicy: Delete
volumeBindingMode: WaitForFirstConsumer
allowVolumeExpansion: true

2. 创建PVC时指定该存储类即可：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-test-pvc1
spec:
  accessModes:
    - ReadWriteOnce
  # 指定自定义的存储类
  storageClassName: biz-pd-standard
  resources:
    requests:
      storage: 10Gi

按上述配置创建的GCE磁盘名称格式为prod-user-svc-<随机后缀>，相比默认的pvc-前缀辨识度高很多。

方案三：静态绑定PV（完全自定义磁盘名称，无自动置备能力） #

如果你需要完全自定义磁盘的完整名称，可以手动提前创建GCE磁盘，再通过静态绑定PV和PVC的方式使用，适合固定用途的存储场景，示例流程如下：

1. 提前在GCE控制台创建你想要名称的磁盘，比如命名为prod-user-data-disk-01
2. 创建对应PV绑定该磁盘：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: prod-user-data-pv-01
spec:
  storageClassName: manual
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteOnce
  csi:
    driver: pd.csi.storage.gke.io
    # 替换为你自己的项目ID、磁盘所在可用区、磁盘名称
    volumeHandle: projects/你的项目ID/zones/磁盘所在可用区/disks/prod-user-data-disk-01
    fsType: ext4

3. 创建PVC绑定该PV：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-test-pvc1
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: manual
  # 指定要绑定的PV名称
  volumeName: prod-user-data-pv-01
  resources:
    requests:
      storage: 10Gi

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