如何通过Kubernetes Secret直接注入SpringBoot数组属性？

我希望实现Kubernetes Secret键到SpringBoot属性的直接映射，用Helm编写了如下配置（原生K8S配置类似）：

apiVersion: v1
data:
  app.entry[0].name: {{.Values.firstEntry.name | b64enc }}
kind: Secret
metadata:
  name: my-secret
type: Opaque

目标是让其效果等同于在Spring配置文件中设置：

app.entry[0].name: "someName"

但执行时出现错误：

Invalid value: "[app.entry[0].name]": a valid config key must consist of alphanumeric characters, '-', '_' or '.' (e.g. 'key.name',  or 'KEY_NAME',  or 'key-name', regex used for validation is '[-._a-zA-Z0-9]+'),

可见Secret键名不允许包含[0]。

我尝试了以下方法，但均失败：

• app.entry[0].name: ... -- Kubernetes拒绝[
• app.entry__0.name: ... -- Kubernetes允许，但Spring未识别为数组
• "app.entry[0].name": ... -- Kubernetes拒绝[
• 'app.entry[0].name': ... -- Kubernetes拒绝[

可行解决方案 #

方案1：利用Spring Boot环境变量转译规则 #

Spring Boot支持将特定格式的环境变量自动映射为数组属性，可借助这一规则绕过Kubernetes Secret的键名限制。

对于目标属性app.entry[0].name，对应的合法环境变量格式为全大写、将.替换为_、去掉方括号直接保留索引数字，即APP_ENTRY_0_NAME。

修改后的Helm配置：

apiVersion: v1
data:
  APP_ENTRY_0_NAME: {{.Values.firstEntry.name | b64enc }}
kind: Secret
metadata:
  name: my-secret
type: Opaque

然后在Pod定义中，将该Secret键映射为环境变量：

env:
- name: APP_ENTRY_0_NAME
  valueFrom:
    secretKeyRef:
      name: my-secret
      key: APP_ENTRY_0_NAME

Spring Boot会自动将这个环境变量解析为app.entry[0].name属性，实现目标映射。

方案2：将Secret挂载为Properties配置文件 #

如果需要配置多条数组属性或复杂结构，可以将Secret内容设为完整的Properties格式，再挂载到Spring Boot的配置目录。

修改Helm配置，把Secret的data设置为Properties格式的字符串：

apiVersion: v1
data:
  application-secret.properties: {{ printf "app.entry[0].name=%s" .Values.firstEntry.name | b64enc }}
kind: Secret
metadata:
  name: my-secret
type: Opaque

接着在Pod中挂载这个Secret到Spring Boot默认读取的/config目录：

volumes:
- name: secret-config
  secret:
    secretName: my-secret
containers:
- name: my-app
  volumeMounts:
  - name: secret-config
    mountPath: /config
    readOnly: true

Spring Boot启动时会自动加载/config目录下的配置文件，直接读取到app.entry[0].name属性。

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