Jenkins+Bitbucket与Jira集成：合并PR至Develop分支校验Jira Fix Version

要实现合并PR到develop分支前校验Jira问题Fix Version的需求，核心思路是在合并触发前启动自动化校验流程，不满足条件则终止合并。以下是分平台的具体实现步骤：

一、选择预合并触发机制 #

不同代码托管平台的拦截方式略有差异：

• GitHub：借助GitHub Actions工作流，结合分支保护规则实现强制校验。工作流监听PR的synchronize、opened和reopened事件，在合并前自动执行校验。
• GitLab：配置CI/CD流水线，设置仅在合并请求事件触发，将校验任务作为流水线的必经环节。
• 其他平台：使用平台提供的pre-receive钩子或自定义Webhook，在合并请求提交时触发校验逻辑。

二、提取PR关联的Jira问题ID #

首先要团队约定PR标题/描述中必须包含Jira问题ID（格式如PROJ-123），然后通过平台内置变量或API提取：

GitHub Actions示例（JS） #

const eventData = require(process.env.GITHUB_EVENT_PATH).pull_request;
const prContent = `${eventData.title}\n${eventData.body}`;
const jiraIssueMatch = prContent.match(/[A-Z]+-\d+/);

if (!jiraIssueMatch) {
  console.error('错误：PR未关联有效Jira问题ID');
  process.exit(1);
}
const jiraIssueId = jiraIssueMatch[0];

GitLab CI示例（Shell） #

JIRA_ISSUE_ID=$(echo "$CI_MERGE_REQUEST_TITLE $CI_MERGE_REQUEST_DESCRIPTION" | grep -o '[A-Z]\+-[0-9]\+' | head -n1)
if [ -z "$JIRA_ISSUE_ID" ]; then
  echo "错误：PR未关联有效Jira问题ID"
  exit 1
fi

三、调用Jira API查询Fix Version #

通过Jira REST API获取目标问题的Fix Version信息，需要提前准备Jira的API令牌（个人访问令牌）：

Node.js示例 #

const axios = require('axios');

async function fetchJiraFixVersions(issueId) {
  try {
    const res = await axios.get(`https://你的Jira域名/rest/api/3/issue/${issueId}`, {
      params: { fields: 'fixVersions' },
      auth: {
        username: '你的Jira邮箱',
        password: '你的Jira API令牌'
      }
    });
    return res.data.fields.fixVersions.map(v => v.name);
  } catch (err) {
    console.error(`查询Jira问题失败：${err.message}`);
    process.exit(1);
  }
}

四、对比版本并拦截合并 #

预设需要匹配的版本（比如通过环境变量REQUIRED_FIX_VERSION传入，或对应develop分支的固定版本），对比Jira返回的Fix Version列表：

校验逻辑示例 #

const requiredVersion = process.env.REQUIRED_FIX_VERSION; // 如"v1.0.0"
const fixVersions = await fetchJiraFixVersions(jiraIssueId);

if (!fixVersions.includes(requiredVersion)) {
  console.error(`错误：Jira问题${jiraIssueId}的Fix Version不匹配，需包含${requiredVersion}，当前为${fixVersions.join(', ')}`);
  process.exit(1); // 终止流程，触发合并拦截
}

五、配置强制校验规则 #

最后要确保校验流程是合并的必要条件：

• GitHub：进入仓库「设置」→「分支保护规则」，为develop分支开启「需要状态检查通过才能合并」，并将你的Actions工作流添加为必需检查项。
• GitLab：进入仓库「设置」→「合并请求」，开启「只有当流水线成功时才能合并」，确保校验任务属于流水线的一部分。

额外注意事项 #

• 权限：确保执行校验的服务账号（如GitHub Actions的Runner、GitLab CI的服务账号）有Jira问题的读取权限。
• 异常处理：覆盖PR无Jira ID、Jira API调用失败等场景，避免漏拦截。
• 灵活匹配：如果需要支持版本前缀匹配（如v1.x），可以用正则表达式替换精确匹配。

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