PersistentVolumeClaim与subPath：单挂载点多子目录存储优化方案咨询

方案一：使用Local Volume Provisioner（推荐） #

这是官方认可的自动化方案，可基于单个根挂载点（如/data）自动为每个PVC生成对应子目录的PV，彻底避免手动重复创建StorageClass和PV的冗余操作。

配置步骤： #

1. 部署Local Volume Provisioner
   以Rancher维护的local-path-provisioner为例，它会监控节点指定目录，自动为PVC生成对应子目录的PV。部署完成后，默认会生成名为local-path的StorageClass。

2. 自定义StorageClass指向根目录
   若需指定/data作为根存储路径，可修改StorageClass配置：

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: local-data
   provisioner: rancher.io/local-path
   volumeBindingMode: WaitForFirstConsumer
   parameters:
     pathPattern: "/data/${.PVC.namespace}/${.PVC.name}"  # 按「命名空间+PVC名」生成子目录，可自定义规则
   

3. 创建PVC
   直接使用该StorageClass创建PVC，Provisioner会自动在节点/data下生成对应子目录并绑定PV：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: prometheus-pvc
     namespace: monitoring
   spec:
     storageClassName: local-data
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 100Gi
   

   每个PVC会对应/data/monitoring/prometheus-pvc这样的独立子目录，权限变更会自动应用到子目录而非根目录/data。

方案二：初始化容器+SubPath 规避权限问题 #

若不想额外部署Provisioner，可通过初始化容器提前创建子目录并设置权限，避免K8s将fsGroup权限变更应用到根目录/data。

配置示例： #

apiVersion: v1
kind: Pod
metadata:
  name: prometheus-pod
spec:
  securityContext:
    runAsUser: 1000
    runAsGroup: 1000
    fsGroup: 1000
    fsGroupChangePolicy: "OnRootMismatch"  # 仅当根目录权限不匹配时才触发变更
  initContainers:
    - name: prepare-dir
      image: busybox:latest
      command: ["sh", "-c", "mkdir -p /data/prometheus && chown 1000:1000 /data/prometheus"]
      volumeMounts:
        - name: data-root
          mountPath: /data
  containers:
    - name: prometheus
      image: prom/prometheus:latest
      volumeMounts:
        - name: data-root
          mountPath: /prometheus/data
          subPath: prometheus
  volumes:
    - name: data-root
      persistentVolumeClaim:
        claimName: data-root-pvc  # 指向绑定了宿主机/data的PV的PVC

说明： #

• 初始化容器提前在/data下创建目标子目录并设置好用户/组权限
• 主容器通过subPath挂载子目录，此时K8s的fsGroup变更只会检查容器内的挂载路径，不会修改宿主机的/data根目录权限

方案三：脚本批量创建PV（适合小规模集群） #

如果集群规模较小，可通过Shell脚本批量生成PV配置，减少手动重复劳动：

#!/bin/bash
# 定义需要创建的PV名称列表
PV_LIST=("prometheus" "grafana" "loki")
STORAGE_CLASS="local-data"
NODE_LABEL="disk=local"

for pv_name in "${PV_LIST[@]}"; do
cat <<EOF > ${pv_name}-pv.yaml
apiVersion: v1
kind: PersistentVolume
metadata:
  name: ${pv_name}
spec:
  storageClassName: ${STORAGE_CLASS}
  capacity:
    storage: 100Gi
  accessModes:
    - ReadWriteOnce
  local:
    path: "/data/${pv_name}"
  nodeAffinity:
    required:
      nodeSelectorTerms:
        - matchExpressions:
            - key: disk
              operator: In
              values:
                - ${NODE_LABEL}
EOF
kubectl apply -f ${pv_name}-pv.yaml
done

同时创建统一的StorageClass：

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: local-data
provisioner: kubernetes.io/no-provisioner
volumeBindingMode: WaitForFirstConsumer

只需维护脚本和一个StorageClass，即可批量生成对应子目录的PV，比手动逐个创建高效得多。

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