Kubernetes StatefulSet如何为每个副本配置不同参数？

现有配置 #

StatefulSet模板文件 #

{{- $outer := . -}}
{{- range $idx, $app := .Values.appliance_type }}
{{- with $outer -}}
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: {{ $app.name }}
  labels:
    app: "{{ $app.appName }}"
    chart: "{{ .Chart.Name }}-{{ .Chart.Version }}"
    release: "{{ .Release.Name }}"
spec:
  replicas: {{ $app.replicaCount }}
  serviceName: {{ $app.serviceName }}
  selector:
    matchLabels:
      app: {{ $app.appName }}
  template:
    metadata:
      labels:
        app: {{ $app.appName }}
    spec:
      containers:
      - name: selfcheck
        image: {{ .Values.image.registry }}/{{ .Values.da.pod.selfcheck.repository}}
        imagePullPolicy: {{ .Values.image.pullPolicy }}
        env:
          - name: POD_IP
            valueFrom:
              fieldRef:
                fieldPath: status.podIP
          - name: CDNHOSTNAME
            value: '{{ $app.hostname }}'
          - name: CUSER
            value: '{{ .Values.da.conf.consoleUser }}'
          - name: CPASSWORD
            value: '{{ .Values.da.conf.consolePassword }}'

{{ end }}
{{- end -}}

原values.yaml文件 #

appliance_type:
  - name: sethu
    hostname : s1
    replicaCount: 2
    serviceName: da
    appName: test-ac
  - name: ram
    hostname : r1
    replicaCount: 1
    serviceName: ida
    appName: test-ia

实际结果 #

• sethu-0 => CDNHOSTNAME (s1)
• sethu-1 => CDNHOSTNAME (s1)
• ram-0 => CDNHOSTNAME (r1)

期望结果 #

• sethu-0 => CDNHOSTNAME (s1)
• sethu-1 => CDNHOSTNAME (s2)
• ram-0 => CDNHOSTNAME (r1)

尝试过的无效配置（values.yaml） #

appliance_type:
  - name: sethu
    hostname : 
      - s1
      - s2
    replicaCount: 2
    serviceName: da
    appName: test-ac
  - name: ram
    replicaCount: 1
    serviceName: ida
    appName: test-ia

解决方案 #

要实现同一个StatefulSet的不同副本使用不同参数，需要结合values.yaml结构调整和Pod运行时动态参数注入来实现：

1. 调整values.yaml结构 #

将需要差异化的参数（如hostname）定义为数组，数组长度与replicaCount保持一致：

appliance_type:
  - name: sethu
    hostname: 
      - s1
      - s2
    replicaCount: 2
    serviceName: da
    appName: test-ac
  - name: ram
    hostname: 
      - r1
    replicaCount: 1
    serviceName: ida
    appName: test-ia

2. 修改StatefulSet模板 #

通过Kubernetes的Downward API获取Pod名称，再通过Shell命令提取Pod序号，最后根据序号从hostname数组中匹配对应值。修改后的模板如下：

{{- $outer := . -}}
{{- range $idx, $app := .Values.appliance_type }}
{{- with $outer -}}
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: {{ $app.name }}
  labels:
    app: "{{ $app.appName }}"
    chart: "{{ .Chart.Name }}-{{ .Chart.Version }}"
    release: "{{ .Release.Name }}"
spec:
  replicas: {{ $app.replicaCount }}
  serviceName: {{ $app.serviceName }}
  selector:
    matchLabels:
      app: {{ $app.appName }}
  template:
    metadata:
      labels:
        app: {{ $app.appName }}
    spec:
      containers:
      - name: selfcheck
        image: {{ .Values.image.registry }}/{{ .Values.da.pod.selfcheck.repository}}
        imagePullPolicy: {{ .Values.image.pullPolicy }}
        # 通过Shell命令动态设置CDNHOSTNAME
        command:
          - /bin/sh
          - -c
          - |
            # 从Pod名称中提取序号（StatefulSet的Pod命名格式为<statefulset-name>-<ordinal>）
            ORDINAL=$(echo "${POD_NAME}" | awk -F '-' '{print $NF}')
            # 将hostname数组转为Shell数组
            HOSTNAMES=({{ range $h := $app.hostname }}"{{ $h }}" {{ end }})
            # 设置环境变量
            export CDNHOSTNAME=${HOSTNAMES[$ORDINAL]}
            # 执行容器原启动命令（请替换为实际启动命令）
            exec /path/to/your/selfcheck/command
        env:
          - name: POD_IP
            valueFrom:
              fieldRef:
                fieldPath: status.podIP
          - name: POD_NAME
            valueFrom:
              fieldRef:
                fieldPath: metadata.name
          - name: CUSER
            value: '{{ .Values.da.conf.consoleUser }}'
          - name: CPASSWORD
            value: '{{ .Values.da.conf.consolePassword }}'

{{ end }}
{{- end -}}

关键说明 #

• Downward API：通过POD_NAME环境变量获取Pod的名称，StatefulSet的Pod命名固定为{StatefulSet名称}-{序号}（序号从0开始）。
• Shell处理：用awk提取Pod名称中的序号，再通过Shell数组索引匹配对应的hostname值。
• 兼容性：如果某个实例的hostname是单个字符串（而非数组），可以在模板中添加kindIs判断，兼容两种格式：

  {{- if kindIs "slice" $app.hostname }}
  # 上述数组处理逻辑
  {{- else }}
  # 直接赋值的逻辑
  env:
    - name: CDNHOSTNAME
      value: '{{ $app.hostname }}'
  {{- end }}
  

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