如何在AKS托管的前端项目中通过Helm生成JSON格式环境变量

Helm内置了toJson函数，可直接将YAML格式的环境变量转换为JSON字符串，以下是两种适配前端场景的实现方案：

方案1：生成JSON配置文件（推荐静态配置场景） #

如果前端项目需要从静态JSON文件读取配置，可通过ConfigMap生成该文件并挂载到容器中：

1. 定义values.yaml中的环境变量 #

frontend:
  env:
    API_BASE_URL: "https://api.your-domain.com"
    APP_TITLE: "AKS Frontend App"
    ENABLE_FEATURE_X: "true"

2. 创建ConfigMap模板（templates/configmap.yaml） #

apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ include "your-chart.fullname" . }}-frontend-config
data:
  config.json: |
    {{ .Values.frontend.env | toJson }}

toJson函数会自动把frontend.env下的键值对转换为标准JSON格式。

3. 在Deployment中挂载ConfigMap #

修改templates/deployment.yaml，将ConfigMap挂载到前端容器的静态资源目录（以Nginx部署的前端为例）：

containers:
  - name: {{ .Chart.Name }}
    image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
    volumeMounts:
      - name: config-volume
        mountPath: /usr/share/nginx/html/config  # 前端读取配置的路径
        readOnly: true
    # ... 其他容器配置（端口、资源限制等）
volumes:
  - name: config-volume
    configMap:
      name: {{ include "your-chart.fullname" . }}-frontend-config

方案2：直接注入JSON格式的环境变量 #

如果前端通过环境变量读取配置，可将JSON字符串作为单个环境变量传入：

修改templates/deployment.yaml的环境变量部分：

env:
  # 保留原有的单个环境变量（可选）
  {{- range $key, $value := .Values.frontend.env }}
  - name: {{ $key }}
    value: {{ $value | quote }}
  {{- end }}
  # 添加JSON格式的聚合环境变量
  - name: APP_CONFIG_JSON
    value: {{ .Values.frontend.env | toJson | quote }}

quote函数会自动转义JSON字符串中的特殊字符，避免YAML解析错误。前端代码中可读取process.env.APP_CONFIG_JSON并解析为JSON对象使用。

注意事项 #

• 确保values.yaml中的frontend.env是标准键值对结构，嵌套对象也能被toJson正确转换
• 若环境变量包含敏感信息（如API密钥），建议改用Secret替代ConfigMap，实现逻辑一致
• 使用ConfigMap挂载时，需确认前端项目的配置读取逻辑指向挂载的config.json路径

内容的提问来源于stack exchange，提问作者Ricardo de Vries