GitLab手动作业导致master分支流水线阻塞问题排查与解决

问题场景 #

我在GitLab CI/CD流水线末尾配置了report阶段，新增了静态分析作业，规则是环境变量RUN_ANALYSIS设为"true"时自动运行，否则设为手动执行，作业配置如下：

RunAnalysis:
  stage: report
  needs: []
  rules:
    - if: $RUN_ANALYSIS == "true"
      when: always
    - if: $RUN_ANALYSIS != "true"
      when: manual
  script:
    - .\RunAnalysis.ps1

分支流水线中，该作业为手动状态时流水线可正常成功；通过调度任务设置RUN_ANALYSIS为"true"时，作业自动执行且流水线也能成功。但在master分支流水线中，其他所有作业均已通过，因未设置RUN_ANALYSIS变量，该作业处于手动状态，却导致流水线状态显示为'Blocked'。

原因分析 #

GitLab对**默认分支（如master）**的流水线状态判断逻辑和普通分支存在差异：普通分支的手动作业未触发时，流水线会判定为已完成并显示成功；但默认分支的流水线要求所有处于待执行状态的作业（包括手动触发的作业）完成后，才会标记为成功。如果手动作业未被触发，流水线就会一直处于Blocked状态——因为GitLab认为默认分支的流水线需要完成所有定义的必需作业，不能跳过。

解决方法 #

方法1：允许手动作业失败（推荐） #

在手动触发的规则里添加allow_failure: true，这样即使手动作业未被触发，流水线也会跳过该作业并标记为成功（仅显示警告，不影响整体状态）。修改后的配置如下：

RunAnalysis:
  stage: report
  needs: []
  rules:
    - if: $RUN_ANALYSIS == "true"
      when: always
    - if: $RUN_ANALYSIS != "true"
      when: manual
      allow_failure: true  # 允许手动作业未触发时不阻塞流水线
  script:
    - .\RunAnalysis.ps1

方法2：针对master分支跳过手动作业 #

如果不想在master分支保留手动触发的选项，可以单独为master分支设置规则，当未设置RUN_ANALYSIS时直接跳过作业：

RunAnalysis:
  stage: report
  needs: []
  rules:
    - if: $RUN_ANALYSIS == "true"
      when: always
    - if: $RUN_ANALYSIS != "true" && $CI_COMMIT_BRANCH != "master"
      when: manual
    - if: $RUN_ANALYSIS != "true" && $CI_COMMIT_BRANCH == "master"
      when: never  # master分支未设置变量时直接跳过该作业
  script:
    - .\RunAnalysis.ps1

方法3：为master分支默认配置变量 #

在项目的CI/CD变量中，针对master分支设置RUN_ANALYSIS变量：

• 若设为"false"，需结合方法1的allow_failure: true才能避免Blocked；
• 若设为"true"，作业会自动执行，无需手动干预，流水线可正常完成。

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