请求Kubernetes StatefulSet绑定单卷并为各副本分配独立subPath目录的方案

你之前在volumeClaimTemplates里配置subPath的思路走偏啦——subPath是Pod挂载存储时的路径映射配置，不属于PVC的定义字段，所以放在volumeClaimTemplates里完全不生效。要实现每个StatefulSet副本使用同一个存储卷的独立子目录，得这么做：

1. 先创建一个共享的PVC（绑定到你的volume 0） #

因为你需要所有副本共享同一个存储卷，所以不需要用volumeClaimTemplates自动生成多个PVC，直接手动创建一个绑定到volume-0存储类的PVC即可：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: shared-volume-claim
spec:
  accessModes:
    - ReadWriteMany  # 必须确保你的存储类支持RWX，否则多Pod无法共享挂载
  storageClassName: volume-0
  resources:
    requests:
      storage: 1Gi

2. 在StatefulSet中引用这个PVC，并动态生成subPath #

利用Kubernetes的Downward API获取Pod的名称，再通过shell字符串提取出副本序号（StatefulSet的Pod命名规则是{sts-name}-0、{sts-name}-1...），以此生成对应的node0、node1子目录：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: my-statefulset
spec:
  serviceName: my-service  # StatefulSet必须指定serviceName
  replicas: 2
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-container
        image: your-image:tag
        # 注入Pod名称到环境变量
        env:
        - name: POD_NAME
          valueFrom:
            fieldRef:
              fieldPath: metadata.name
        # 挂载共享PVC，用环境变量动态生成subPath
        volumeMounts:
        - name: shared-volume
          mountPath: /data
          subPath: "node$(POD_NAME##*-)"  # 提取Pod名称最后一段作为序号，生成node0、node1
      volumes:
      - name: shared-volume
        persistentVolumeClaim:
          claimName: shared-volume-claim  # 引用刚才创建的共享PVC

3. 可选：用InitContainer确保子目录存在 #

有些存储卷不会自动创建不存在的目录，你可以加个InitContainer提前创建对应子目录，避免挂载失败：

spec:
  template:
    spec:
      initContainers:
      - name: create-node-dir
        image: busybox:latest
        command: ["sh", "-c", "mkdir -p /shared/node$(POD_NAME##*-)"]
        env:
        - name: POD_NAME
          valueFrom:
            fieldRef:
              fieldPath: metadata.name
        volumeMounts:
        - name: shared-volume
          mountPath: /shared
      containers:
      # 你的业务容器配置...

关键说明 #

• 为什么不用volumeClaimTemplates？因为它的作用是给每个StatefulSet副本生成独立的PVC，而你需要的是共享同一个存储卷，所以直接复用单个PVC才是正确的选择。
• subPath支持环境变量替换：Kubernetes会在Pod启动时解析subPath里的环境变量，所以node$(POD_NAME##*-)会被替换成对应的node0、node1。
• 必须确保存储类支持ReadWriteMany：只有RWX类型的存储卷才能被多个Pod同时挂载，否则会出现挂载失败的情况。

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