如何实现GitLab文件类型变量在另一文件变量中展开并覆盖配置

核心方案：CI脚本合并并去重覆盖 #

GitLab的文件类型变量会将内容写入临时文件，对应的环境变量（大写、下划线命名，如file1对应$FILE1）指向该文件的路径。我们可以在CI job中通过脚本读取两个文件的内容，合并时自动覆盖重复的键值对。

步骤1：设置GitLab文件变量 #

在项目的「Settings → CI/CD → Variables」中添加两个文件类型变量：

• 变量名：file1，内容：

  DB_HOST=localhost
  
  DB_USER=admin
  

• 变量名：file2，内容：

  DB_USER=newUserName
  

（注：file2无需写入$file1，脚本会主动合并file1的内容）

步骤2：在CI job中添加合并脚本 #

在.gitlab-ci.yml的目标job里，添加脚本步骤生成最终的合并配置文件：

job_name:
  script:
    # 合并file1和file2的内容，重复键以file2的配置为准
    - { cat "$FILE1"; cat "$FILE2"; } | awk '!/^$/{key=$0; sub(/=.*/,"",key); if(!seen[key]++) print $0}' > final.env
    # 验证合并结果（可选）
    - cat final.env
    # 后续使用final.env，比如加载环境变量
    - source final.env
    - echo "DB_HOST is $DB_HOST, DB_USER is $DB_USER"

脚本说明 #

• cat "$FILE1"; cat "$FILE2"：按顺序读取两个文件变量的内容
• awk命令逻辑：
  • !/^$/：跳过空行
  • key=$0; sub(/=.*/,"",key)：提取每行的键名（等号前的部分）
  • if(!seen[key]++) print $0：记录已出现的键，仅打印首次出现的键值对（先读file1，后读file2，最终保留file2的重复键配置）

为什么直接展开变量不可行？ #

• 文件类型变量：GitLab不会将文件内容直接注入到其他变量中，$file1实际指向的是临时文件的路径，而非内容，所以直接在file2中写$file1只会输出路径字符串。
• 普通类型变量：虽然能展开内容，但GitLab不会自动处理重复键的覆盖，只会简单拼接，导致重复配置存在。

其他补充 #

如果需要更复杂的合并逻辑（比如保留注释、处理特殊格式），可以调整awk脚本或者使用专门的.env合并工具，但上述方案已经能满足基础的键值对覆盖需求，且无需提交额外代码到仓库。

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