Gitlab CI并行矩阵任务导致流水线无法触发问题咨询

核心原因 #

你的矩阵任务无触发、无记录的问题，本质是Docker Machine Runner的按需扩容速度跟不上GitLab并行Job的调度节奏，加上旧版本Runner的调度逻辑限制，导致Job在等待执行器就绪的过程中被静默丢弃。

是否需要预启动空闲执行器？ #

不需要强制预启动大量空闲执行器，但少量的空闲执行器可以避免扩容延迟导致的Job丢失。不过核心问题是扩容机制的响应速度，而非必须预启动。

能否不提高空闲Runner数量运行并行任务？ #

可以，通过调整Runner配置和扩容策略来实现：

• 调整Runner核心并发配置
  确保Runner管理器的config.toml中：

  • concurrent（全局最大并发数）的值不小于你的矩阵任务的并行总数，比如矩阵有4个并行Job，concurrent至少设为4（你的limit=6已经满足单个Runner的并发上限，但全局concurrent不能拖后腿）。
  • 确认单个Runner的limit=6配置正确生效，没有被其他全局配置覆盖。

• 优化Docker Machine扩容参数
  在config.toml的[[runners.machine]]段添加/调整以下参数：

  • machine_build_timeout = 600：缩短EC2实例创建超时（默认可能更长），让Runner更快放弃创建失败的实例并尝试新的，避免Job无限等待。
  • machine_idle_count = 1：保留1个空闲执行器，应对突发并行请求，不用预启动多个，但能减少首次扩容的等待时间。
  • machine_idle_time = 3600：延长空闲执行器的存活时间，避免刚销毁就需要重新创建。

• 检查GitLab Job超时设置
  在项目的「CI/CD设置」中，确保Job超时时间足够长（比如至少15分钟），给Runner留出扩容实例的时间，避免Job还没等到执行器就绪就被系统取消。

• 升级Runner版本
  GitLab Runner 14.1.0属于旧版本，并行任务调度、Docker Machine扩容的稳定性在后续版本（如15.x、16.x）有明显优化，升级后能减少这类静默调度失败的问题。

• 验证标签匹配
  确认矩阵任务的tags字段和你的Runner标签完全一致，虽然其他任务正常，但矩阵任务如果漏写标签，也会导致无法被调度。

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