Gerrit与Jira Cloud集成求助：its-jira插件配置异常

一、完整集成实施步骤 #

1. 安装启用its-jira插件 #

• 下载对应Gerrit版本的its-jira.jar，放到Gerrit服务器的plugins目录
• 编辑gerrit.config，添加插件启用配置：

  [plugin "its-jira"]
    enabled = true
  

• 重启Gerrit服务

2. 配置Jira Cloud连接参数 #

在gerrit.config里补充Jira核心配置：

[its-jira]
  url = https://你的Jira域名.atlassian.net/
  username = 你的Jira注册邮箱
  token = 你的Jira API令牌
  # 可选：自定义提交消息中Jira ID的匹配规则，默认支持PROJ-123这类格式
  issuePattern = ([A-Z]+-[0-9]+)

注意：API令牌需从Jira个人设置的「安全」板块生成，确保该账号拥有Jira工单的评论权限。

3. 设置Gerrit触发规则 #

编辑项目的project.config（全局配置修改etc/project.config），配置提交关联Jira ID时自动同步评论：

[its]
  enable = true
[its-jira]
  action = comment
  # 可选：自定义Jira评论内容，支持变量替换
  comment = Gerrit提交 ${commit} 已关联：${url}

• ${commit}会替换为提交哈希，${url}为Gerrit提交的页面链接
• 修改完成后重启Gerrit让配置生效

4. 测试集成 #

提交代码时，将Jira工单ID写入提交消息（例如TEST-123: 修复支付回调bug），随后检查Jira对应工单的评论区是否同步Gerrit内容。

二、解决「Jira问题ID不存在」错误 #

1. 核对Jira ID格式 #

• 提交消息中的Jira ID需与Jira平台上完全一致，比如Jira工单是TEST-456，不能写成test-456（大小写敏感）
• 检查项目键拼写，避免输入错误

2. 验证API令牌和权限 #

• 用curl测试Jira API是否能访问目标工单：

  curl -u 你的Jira邮箱:API令牌 https://你的Jira域名.atlassian.net/rest/api/3/issue/TEST-456
  

  返回401代表令牌或邮箱错误；返回404说明该Jira账号无目标工单的访问权限

3. 检查正则匹配规则 #

• 如果自定义了issuePattern，确认正则能匹配提交消息中的Jira ID，比如默认规则仅识别大写项目键，若项目键为小写，需调整为([a-zA-Z]+-[0-9]+)

4. 查看Gerrit日志定位问题 #

• 查看Gerrit的logs/error_log或logs/its_log，搜索对应的Jira ID，日志中会包含更详细的错误信息（比如Jira API返回的具体错误码）

三、验证期望效果 #

提交代码时按格式编写提交消息（例如PROJ-789: 完成用户导出功能），提交后：

• Gerrit自动识别Jira ID
• 自动调用Jira API在对应工单评论区添加带Gerrit提交链接的评论
• 若配置了其他动作（如更新工单状态），也会同步执行

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