本地使用gitlab-runner执行含include配置的CI/CD任务失败咨询

问题原因 #

gitlab-runner exec 命令本身存在设计限制，不支持解析CI配置中的include字段，仅会读取当前目录下.gitlab-ci.yml的直接内容，不会加载include指向的其他配置文件，因此拆分配置后本地执行时无法识别拆分出去的任务。你推送至远端仓库可以正常运行，是因为GitLab服务端的CI引擎会完整解析所有include引用，合并生成完整的流水线配置后再执行任务，和本地执行逻辑不同。
这个问题是通用已知问题，不需要修改gitlab-runner的基础配置，调整本地执行方式即可解决。

可行解决方案 #

• 方案1：使用GitLab官方CLI工具glab的ci run命令执行本地任务，该命令支持完整解析include等所有GitLab CI特性，也是官方目前推荐的替代gitlab-runner exec的本地CI测试方案，命令示例：

  glab ci run test1
  

• 方案2：使用yq等YAML处理工具，先把所有关联的CI配置合并为单文件，再用gitlab-runner exec执行，合并执行示例：

  # 合并主配置和拆分的配置到临时文件
  yq eval-all '. as $item ireduce ({}; . * $item)' .gitlab-ci.yml .gitlab/test-pipeline.yml > temp-ci.yml
  # 指定临时配置文件执行任务
  gitlab-runner exec shell test1 --ci-config temp-ci.yml
  # 执行完成后删除临时文件
  rm temp-ci.yml
  

• 方案3：仅做小改动测试时，可临时将拆分出去的配置内容复制回主.gitlab-ci.yml中，测试通过后再恢复拆分结构即可。

内容的提问来源于stack exchange，提问作者Дима Коробков