如何让csi-driver-nfs创建PV时自动生成NFS子目录并自定义PV名？

一、优先方案：手动创建PV时自动生成NFS子目录 #

csi-driver-nfs的静态PV模式默认不会自动创建subDir指定的目录，必须显式添加createSubDir: "true"参数到volumeAttributes中，同时要确保NFS服务器的父共享目录（如你的/mnt/nfs）具备可写入权限，让CSI驱动能在其中创建子目录。

修正后的PV YAML：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: nfs-pv
spec:
  accessModes:
    - ReadWriteOnce
  capacity:
    storage: 1Gi
  csi:
    driver: nfs.csi.k8s.io
    volumeAttributes:
      server: 192.168.1.10
      share: /mnt/nfs
      subDir: nfs-pv
      createSubDir: "true" # 新增此参数开启自动创建子目录
    volumeHandle: nfs-pv
  mountOptions:
    - nfsvers=4.1
  persistentVolumeReclaimPolicy: Retain
  storageClassName: nfs-csi-retain
  volumeMode: Filesystem

注意事项： #

• 确认NFS服务器上/mnt/nfs目录的权限：执行chmod 777 /mnt/nfs（或调整为CSI驱动运行用户的权限），避免因权限不足导致创建子目录失败。
• volumeHandle必须唯一，建议和PV名称保持一致，避免冲突。

二、动态存储方案：自定义PV关联的NFS目录名并复用PV #

如果想用动态存储（StorageClass）实现自定义目录名，可通过配置StorageClass的参数来指定子目录命名规则，同时保留PV以便后续复用：

1. 创建自定义参数的StorageClass #

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: nfs-csi-custom
provisioner: nfs.csi.k8s.io
parameters:
  server: 192.168.1.10
  share: /mnt/nfs
  subDir: ${.PVC.metadata.name} # 用PVC名称作为NFS子目录名
reclaimPolicy: Retain # 删除PVC后保留PV，方便后续复用
volumeBindingMode: Immediate
mountOptions:
  - nfsvers=4.1

2. 复用原有PV的方法 #

• 创建PVC时不指定volumeName，驱动会自动生成PV，对应的NFS子目录名就是PVC的名称。
• 若后续需要重建PVC，只需在新PVC的spec中添加volumeName: <原有PV名称>，即可绑定到已存在的PV和对应的NFS目录。
• 动态生成的PV名称格式为pvc-<uuid>，可通过kubectl get pv查看并记录，方便后续绑定。

问题排查补充 #

你之前遇到的No such file or directory报错，核心原因就是静态PV模式下未开启createSubDir: "true"，驱动不会自动创建子目录，加上该参数并确保NFS目录权限后即可解决。

内容的提问来源于stack exchange，提问作者Nguyễn Đức Huy