调度流水线变量无法注入到被包含的GitLab CI YAML文件中

原因分析 #

导致$foo被当作字面量传递的核心原因主要有以下几点：

• Shell解析优先级问题：GitLab CI作业脚本默认由Runner的Shell（如bash）解析，若脚本中的变量未用双引号包裹，Shell可能无法正确识别并展开$foo；或者变量在Shell环境中未被正确导出。
• 变量权限传递异常：如果foo是手动触发流水线时临时输入的变量，且被设置为受保护（Protected），但当前作业运行的分支/环境不属于受保护范围，变量就不会被传递到作业环境中，导致Shell无法解析。
• GitLab CI插值时机问题：当外部include的文件脚本未触发GitLab CI的变量插值流程，直接传递给Shell处理时，若Shell环境中不存在该变量，就会保留字面量$foo。

解决方案 #

你可以按以下步骤排查并解决：

1. 用双引号包裹变量，强制Shell解析
   修改gitlab-ci-common.yml中的脚本，将变量部分用双引号包裹，确保Shell正确识别变量：

   deploy_production:
     stage: test
     environment: test
     script:
       - mvn test -Dfoo="$foo"
   

2. 验证变量是否存在于作业环境
   在脚本中添加变量打印命令，确认变量是否被正确传递：

   deploy_production:
     stage: test
     environment: test
     script:
       - echo "当前foo变量值: $foo"
       - mvn test -Dfoo="$foo"
   

   通过流水线日志查看echo的输出，即可判断变量是否正常传递。

3. 检查变量权限设置
   进入项目的Settings > CI/CD > Variables页面：

   • 若foo被标记为Protected，需确保作业运行的分支/环境属于受保护范围；
   • 若foo被标记为Masked，需确认变量值符合正则规则（无空格、特殊字符等），否则无法正常传递。

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