GitLab如何指定Jenkins触发流水线需通过的特定Job？

一、无需YAML的实现方式（仅GitLab Ultimate Tier可用） #

GitLab 仅Ultimate 版本提供的「状态检查（Status Checks）」功能支持类似GitHub分支保护规则的配置：在项目「设置」→「合并请求」→「状态检查」中添加Jenkins推送的特定Job名称，将其设为MR合并的前置条件。但GitLab基础版无此UI配置项，必须通过YAML流水线文件实现。

二、GitLab基础版的YAML实现方式 #

方法1：验证指定Jenkins Job状态 #

在项目根目录创建.gitlab-ci.yml，添加一个检查任务，通过GitLab API验证目标Jenkins Job的状态是否为成功：

check_required_jenkins_job:
  stage: pre-merge
  script:
    # 获取指定Jenkins Job的状态
    - JOB_STATUS=$(curl --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/merge_requests/$CI_MERGE_REQUEST_IID/statuses" | jq -r '.[] | select(.name == "你的Jenkins Job名称") | .state')
    # 状态非success则终止流水线
    - if [ "$JOB_STATUS" != "success" ]; then echo "Required Jenkins job failed"; exit 1; fi
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  variables:
    GITLAB_API_TOKEN: $PROJECT_GITLAB_TOKEN # 需在项目CI/CD变量中配置带read_api权限的令牌

配置说明：

• 需在项目「设置」→「CI/CD」→「变量」中添加PROJECT_GITLAB_TOKEN，令牌权限需包含read_api
• 替换你的Jenkins Job名称为实际需要校验的Jenkins任务名称

方法2：将Jenkins Job标记为流水线必需任务 #

如果Jenkins Job是GitLab流水线的触发任务，可直接在YAML中标记其为required：

trigger_jenkins_job:
  stage: build
  trigger:
    project: your/jenkins-integration-project # 关联Jenkins集成项目
    strategy: depend # 等待Jenkins任务执行完成
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  required: true # 标记为必须通过的任务

然后在项目「设置」→「合并请求」→「流水线」中勾选「只有当所有必需的作业都成功时才允许合并」，此时仅标记为required的Jenkins Job通过后，MR才能合并。

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