GitLab中无有效JIRA ID时自动阻止PR合并的实现方案咨询

方案1：CI/CD流水线验证（推荐，适用于所有GitLab环境） #

• 编写自定义CI/CD作业，在合并请求触发的流水线中完成两项核心检查：
  1. 从合并请求的标题、描述或关联提交信息里，提取符合格式的JIRA工单ID（比如PROJ-\d+这类规则）
  2. 调用JIRA API验证该工单是否存在、状态是否符合要求（比如处于「进行中」「待开发」等有效状态）
• 将该作业设为流水线的必填阶段，只有作业返回成功时，流水线才会通过
• 在项目的「合并请求设置」中开启「需要流水线成功」，确保只有验证通过的MR才能进入合并环节

示例CI脚本（伪代码）：

# 从MR描述中提取JIRA工单ID
JIRA_ID=$(echo "$CI_MERGE_REQUEST_DESCRIPTION" | grep -oE "PROJ-[0-9]+")

# 检查是否提取到有效ID
if [ -z "$JIRA_ID" ]; then
  echo "错误：未找到符合格式的JIRA工单ID"
  exit 1
fi

# 调用JIRA API验证工单有效性
RESPONSE=$(curl -s -u "$JIRA_USER:$JIRA_TOKEN" "https://your-jira-domain/rest/api/2/issue/$JIRA_ID")

# 检查工单是否存在
if echo "$RESPONSE" | grep -q "errorMessages"; then
  echo "错误：JIRA工单 $JIRA_ID 不存在或无权限访问"
  exit 1
fi

# 检查工单状态（示例要求状态为"In Progress"）
STATUS=$(echo "$RESPONSE" | jq -r '.fields.status.name')
if [ "$STATUS" != "In Progress" ]; then
  echo "错误：JIRA工单 $JIRA_ID 状态不符合要求，当前状态为 $STATUS"
  exit 1
fi

echo "JIRA工单验证通过"
exit 0

注意：需在项目CI/CD变量中配置JIRA_USER、JIRA_TOKEN等敏感信息，避免硬编码。

方案2：服务器端钩子（适用于自托管GitLab） #

• 编写merge-request钩子脚本，在合并操作触发前自动执行
• 脚本从GitLab获取MR的相关信息，完成JIRA工单的存在性和有效性验证
• 如果验证失败，返回非零状态码，直接阻止合并操作
• 钩子脚本需部署在GitLab服务器的custom_hooks目录下，具体路径可参考GitLab官方文档的钩子配置说明

方案3：GitLab-JIRA官方集成（最简方案） #

• 配置GitLab与JIRA的官方集成，在项目的「集成」-「JIRA」设置中开启强制关联规则
• 启用「合并请求必须关联至少一个JIRA工单」选项，部分版本还支持配置工单的状态过滤规则
• 该方案无需自定义代码，依赖官方集成能力，适合GitLab SaaS或已完成JIRA集成的环境

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