GitLab流水线首阶段手动可选作业配置后后续作业阻塞问题

问题原因 #

GitLab流水线默认按阶段顺序执行，只有当前一阶段的所有已触发作业完成（或被标记为失败但允许失败）后，才会进入下一阶段。你的$-estimate | stable作业配置了when: manual，即使设置了allow_failure: true，它仍会处于「等待手动触发」的状态，导致整个prepare阶段无法结束，进而阻塞后续deploy阶段的作业运行。

解决方案 #

方案一：给手动作业添加optional: true（推荐） #

在GitLab 14.2及以上版本中，when: manual支持optional: true参数，开启后手动作业不会阻塞流水线——如果用户不触发它，流水线会自动跳过该作业并进入下一阶段，同时保留手动触发的能力。

修改你的规则模板：

.rule-templates:
  [...]
  manual-run-branch: &rule-manual-run-branch
    if: $CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH
    when: manual
    optional: true  # 添加这一行
    allow_failure: true
  [...]

方案二：让作业仅在需要时才加入流水线 #

通过变量控制作业是否被包含进流水线，只有当用户明确需要运行估算作业时，才让它出现在prepare阶段。

修改规则模板：

.rule-templates:
  [...]
  manual-run-branch: &rule-manual-run-branch
    if: $CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH && $RUN_ESTIMATE == "true"
    when: manual
    allow_failure: true
  [...]

触发流水线时，若需要运行估算作业，传入RUN_ESTIMATE=true变量即可；否则prepare阶段无此作业，后续阶段直接运行。

方案三：给后续作业配置needs: [] #

让deploy | stable作业跳过阶段依赖，直接开始执行。此方法会打破流水线的阶段顺序，若prepare阶段有其他必须运行的作业，不建议使用。

配置示例：

deploy | stable:
  # ... 原有配置
  needs: []  # 添加这一行

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