如何通过Helm将GitLab CI/CD中的JSON配置注入应用？

核心问题分析 #

你遇到的问题根源有两个：

1. 直接用--set传递JSON字符串时，Helm会把它解析为YAML对象而非保留原始字符串，导致后续ConfigMap引用时结构混乱。
2. ConfigMap的YAML模板未正确处理JSON字符串格式，引发YAML解析错误或文件内容异常。

具体解决步骤 #

1. 修正GitLab CI中Helm变量传递方式

将--set替换为--set-string，强制Helm把DEPLOYTIMECONFIG当作纯字符串处理，避免自动解析：

--set-string deploytimeconfig="${DEPLOYTIMECONFIG}" \

注意用双引号包裹变量，防止Shell解析JSON中的特殊字符（如空格、引号）

2. 调整ConfigMap模板格式

在ConfigMap的data字段中，用YAML多行字符串标记|-配合nindent函数，确保JSON内容被正确渲染为文件：

apiVersion: v1
kind: ConfigMap
metadata:
    name: {{ .Values.api.name }}
data:
    deploytimeconfig.json: |-
        {{ .Values.deploytimeconfig | nindent 8 }}

• |-表示保留多行字符串格式，同时去掉末尾换行
• nindent 8给JSON内容添加8个空格缩进，匹配YAML层级结构，避免解析错误

3. 验证JSON合法性

检查GitLab中DEPLOYTIMECONFIG变量的JSON格式，确保无语法错误：

• 移除数组/对象最后一个元素后的多余逗号（比如你示例中dbs数组里"password": "pass",的末尾逗号）
• 移除JSON不支持的注释（如// some others envs）

备选方案：使用GitLab文件类型变量 #

如果JSON内容较长或格式复杂，可将DEPLOYTIMECONFIG设置为GitLab的File类型变量，然后在CI中读取文件内容传递给Helm：

--set-string deploytimeconfig="$(cat "$DEPLOYTIMECONFIG")" \

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