如何将Kubernetes保留的PVC重新关联至现有Azure磁盘？

我们使用Azure CSI驱动v1.27.1、Kubernetes v1.23（非AKS，基于Rancher引擎RKE），将所有PVC设置为Retain回收策略。删除PVC/PV后Azure磁盘仍保留，这符合预期，但重新创建同名PVC/PV时，系统会生成新的Azure磁盘而非复用现有磁盘。原以为会通过PVC的命名空间/标签自动实现复用，请问如何才能复用现有磁盘？目前手动关联的语法不够便捷，手动关联的配置如下：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: test-reclaim
  finalizers:
    - kubernetes.io/pv-protection
    - external-attacher/disk-csi-azure-com
spec:
  capacity:
    storage: 1Gi
  accessModes:
    - ReadWriteOnce
  claimRef:
    namespace: default
    name: test-reclaim
  storageClassName: azure-disk-retain
  volumeMode: Filesystem
  csi:
    driver: disk.csi.azure.com
    volumeHandle: /subscriptions/XXXXXX/resourceGroups/rg-XXXX/providers/Microsoft.Compute/disks/pvc-XXXXXX
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: test-reclaim
spec:
  storageClassName: azure-disk-retain
  volumeName: test-reclaim
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi

1. 简化手动关联流程 #

你当前的手动绑定方式可行，但可以优化得更便捷：

• 当PV处于Released状态（删除PVC后），只需移除PV的claimRef字段，就能让PV变回Available状态，新创建的同名PVC会自动绑定该PV，无需在PVC中指定volumeName。
• 操作步骤：
  1. 编辑目标PV：

     kubectl edit pv test-reclaim
     

  2. 删除spec.claimRef的全部内容，保存退出。
  3. 直接创建同名PVC即可自动绑定：

     apiVersion: v1
     kind: PersistentVolumeClaim
     metadata:
       name: test-reclaim
     spec:
       storageClassName: azure-disk-retain
       accessModes:
         - ReadWriteOnce
       resources:
         requests:
           storage: 1Gi
     

2. 直接指定现有磁盘创建PV #

如果磁盘已经存在（比如删除PV/PVC后保留的磁盘），可以直接创建PV时通过磁盘名称和资源组关联，无需填写完整的volumeHandle路径：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: test-reclaim
spec:
  capacity:
    storage: 1Gi
  accessModes:
    - ReadWriteOnce
  storageClassName: azure-disk-retain
  volumeMode: Filesystem
  csi:
    driver: disk.csi.azure.com
    volumeAttributes:
      diskName: pvc-XXXXXX  # 替换为你的Azure磁盘名称
      resourceGroup: rg-XXXX  # 替换为磁盘所在的资源组

创建该PV后，直接创建匹配存储类、容量和访问模式的PVC，即可自动绑定。

3. 自动化复用：使用VolumeSnapshot（推荐） #

如果需要更自动化的复用流程，推荐使用Kubernetes VolumeSnapshot功能，基于现有磁盘创建快照后直接生成PVC：

1. 确保集群已部署CSI快照控制器和Azure CSI快照驱动（Azure CSI v1.27.1原生支持）。
2. 创建SnapshotClass：

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
     name: azure-disk-snapclass
   driver: disk.csi.azure.com
   deletionPolicy: Retain
   

3. 基于原PVC创建磁盘快照：

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: test-disk-snapshot
   spec:
     volumeSnapshotClassName: azure-disk-snapclass
     source:
       persistentVolumeClaimName: test-reclaim  # 原PVC名称
   

4. 通过快照创建新PVC：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-reclaim
   spec:
     storageClassName: azure-disk-retain
     dataSource:
       name: test-disk-snapshot
       kind: VolumeSnapshot
       apiGroup: snapshot.storage.k8s.io
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 1Gi
   

这种方式无需手动管理PV，直接通过快照复用磁盘数据，适合需要频繁复用或自动化的场景。

关键注意点 #

• Kubernetes的Retain回收策略仅保证磁盘不被删除，不会自动复用磁盘——因为PV被删除后，系统没有内置的逻辑将新PVC关联到原磁盘。
• 所有复用操作必须确保PVC的存储类、容量、访问模式与目标磁盘/PV完全匹配，否则无法完成绑定。

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