如何为Kubernetes Pod添加临时磁盘？配置报PVC不存在如何解决

报错persistentvolumeclaim "cont-xxx-extra-disk" not found的核心原因是你当前使用的Jenkins Kubernetes插件版本过低，不支持Kubernetes原生通用临时卷（ephemeral volume）配置。

• 你写的ephemeral.volumeClaimTemplate是Kubernetes 1.21+版本稳定支持的特性，正常逻辑是Kubernetes会根据模板自动生成对应命名规则的临时PVC，Pod销毁后PVC自动删除。
• 低于3.1.0版本的Jenkins Kubernetes插件在解析Pod YAML时，会直接丢弃volumes[].ephemeral字段的配置，仅保留卷的挂载引用，最终下发给Kubernetes API的Pod配置会把extra-disk卷识别为引用已有PVC的类型，Kubernetes找不到对应名称的预创建PVC就会抛出该报错。
• 少数情况是Kubernetes集群版本低于1.21，未开启GenericEphemeralVolume特性门控，无法自动生成临时PVC。

根据你的环境选其中一种即可：

方案1：升级插件（最小改动） #

将Jenkins的Kubernetes插件升级到3.1.0以上的稳定版本，升级后你现有的YAML配置不需要任何修改，就能正常自动创建临时SSD卷挂载到/extra-disk路径，Pod销毁后存储自动回收。

验证方式：Pod调度失败时，执行kubectl get pod <失败Pod名> -o yaml查看spec.volumes字段，如果extra-disk卷下存在完整的ephemeral配置块，说明插件已经正确识别配置，等待PVC自动绑定即可。

方案2：兼容低版本插件/集群的配置写法 #

如果暂时不能升级插件或集群版本，可以直接用插件原生支持的动态PVC方式实现临时存储，只要你使用的cloudbees-ssd存储类配置了reclaimPolicy: Delete（云厂商SSD存储类默认都是该策略），Pod销毁后PVC和对应存储会自动删除，和原生临时卷效果一致，配置示例：

containers:
  - name: cont
    volumeMounts:
    - mountPath: /extra-disk
      name: extra-disk
volumes:
  - name: extra-disk
    persistentVolumeClaim:
      claimName: "extra-disk-${BUILD_NUMBER}"
# Jenkins Kubernetes插件识别的动态PVC创建规则
persistentVolumeClaims:
- mountPath: /extra-disk
  name: extra-disk
  spec:
    accessModes: [ "ReadWriteOnce" ]
    storageClassName: "cloudbees-ssd"
    resources:
      requests:
        storage: 200Gi

方案3：本地临时盘场景 #

如果你不需要使用CSI提供的云SSD，只需要节点本地的临时存储空间，可以直接用emptyDir实现，兼容性最好，不需要依赖存储类：

containers:
  - name: cont
    volumeMounts:
    - mountPath: /extra-disk
      name: extra-disk
volumes:
  - name: extra-disk
    emptyDir:
      sizeLimit: 200Gi

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