如何正确将对象列表写入Kubernetes ConfigMap？

一、ConfigMap中正确配置列表的方式 #

你之前使用的扁平化键值对写法（如accounts.service[0].id）无法生效，是因为大多数应用的配置加载器不支持这种语法来解析嵌套列表。正确的做法是在ConfigMap中使用完整的YAML块结构来定义列表：

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  config.yaml: |
    accounts:
      service:
        - id: id0
          username: username0
          password: password0  # 后续会迁移到Secret
        - id: id1
          username: username1
          password: password1
        - id: id2
          username: username2
          password: password2

将这个ConfigMap挂载到应用容器的配置目录后，会覆盖默认的accounts.service列表。如果你的应用支持配置合并（比如Spring Boot的配置优先级机制），也可以只定义需要修改的部分，但如果是直接替换配置文件，必须写完整的列表结构。

二、将密码迁移到Secret中 #

1. 创建存储密码的Secret #

首先用Base64编码每个密码（注意不要带换行），然后创建Secret：

apiVersion: v1
kind: Secret
metadata:
  name: app-secrets
type: Opaque
data:
  password0: dXNlcm5hbWUwX3Bhc3N3b3Jk  # echo -n 'password0' | base64 生成的结果
  password1: dXNlcm5hbWUxX3Bhc3N3b3Jk
  password2: dXNlcm5hbWUyX3Bhc3N3b3Jk

2. 关联Secret与应用配置 #

有两种常用方式让应用获取Secret中的密码：

方式一：环境变量注入+配置占位符修改

修改ConfigMap，将密码替换为环境变量占位符（需应用支持环境变量替换配置）：

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  config.yaml: |
    accounts:
      service:
        - id: id0
          username: username0
          password: ${PASSWORD0}
        - id: id1
          username: username1
          password: ${PASSWORD1}
        - id: id2
          username: username2
          password: ${PASSWORD2}

然后在Deployment中注入Secret作为环境变量：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: app-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-app
        image: your-app-image
        volumeMounts:
        - name: config-volume
          mountPath: /path/to/config  # 替换为应用实际的配置目录
        env:
        - name: PASSWORD0
          valueFrom:
            secretKeyRef:
              name: app-secrets
              key: password0
        - name: PASSWORD1
          valueFrom:
            secretKeyRef:
              name: app-secrets
              key: password1
        - name: PASSWORD2
          valueFrom:
            secretKeyRef:
              name: app-secrets
              key: password2
      volumes:
      - name: config-volume
        configMap:
          name: app-config

应用启动时会自动将环境变量值替换到配置的占位符中。

方式二：Secret文件挂载+应用读取文件

如果应用支持从文件读取密码值，可以直接将Secret挂载为文件，然后在ConfigMap中配置文件路径：

修改ConfigMap：

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  config.yaml: |
    accounts:
      service:
        - id: id0
          username: username0
          password: /secrets/password0
        - id: id1
          username: username1
          password: /secrets/password1
        - id: id2
          username: username2
          password: /secrets/password2

然后在Deployment中挂载Secret：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: app-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-app
        image: your-app-image
        volumeMounts:
        - name: config-volume
          mountPath: /path/to/config
        - name: secret-volume
          mountPath: /secrets
          readOnly: true
      volumes:
      - name: config-volume
        configMap:
          name: app-config
      - name: secret-volume
        secret:
          secretName: app-secrets

三、处理列表长度随机的情况 #

如果账户数量不固定，可以采用前缀匹配的环境变量来动态生成列表：

1. 在ConfigMap中不硬编码列表，而是让应用启动时从环境变量读取所有账户配置。比如命名环境变量为ACCOUNT_0_ID、ACCOUNT_0_USERNAME、ACCOUNT_1_ID等，密码仍存放在Secret中，对应环境变量ACCOUNT_0_PASSWORD。
2. 应用内部添加逻辑，遍历所有以ACCOUNT_开头的环境变量，分组后构建accounts.service列表。这种方式不需要修改ConfigMap的结构，就能适配任意数量的账户。

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