Gerrit 3.8.0与Jira集成失败求助:如何实现提交追踪?
Gerrit 3.8.0 与 Jira 集成故障排查(提交追踪失效)
先修正配置文件中的明显错误
你的gerrit.config存在几处配置错误,这是集成失效的核心原因,先修正这些内容:
[its-jira] # 修正Jira实例地址(原配置域名与路径符号错误) url = https://xxxx.atlassian.com # Jira账号邮箱(保持不变) username = xxxxx@xxxx.com # 新增认证字段:Jira云需用API Token替代密码 apiToken = 你的Jira API Token # 超时配置可保留,单位ms可省略直接写数字 connectTimeout = 120000 readTimeout = 30000 [commentlink "its-jira"] match = ([A-Z]+-[0-9]+) # 修正双斜杠为单斜杠 html = <a href="https://xxxx.atlassian.com/browse/$1">$1</a> [plugin "its-jira"] association = MANDATORY
关键配置补充说明
- 认证方式:Jira云不支持直接用账号密码调用API,需前往Jira个人设置生成API Token,替换配置里的
apiToken字段。 - 提交信息要求:因
association = MANDATORY,所有Gerrit提交的commit message必须包含Jira工单关键字(例如PROJ-123),格式需匹配commentlink的match规则(大写字母+横杠+数字)。 - 账号权限:确保Gerrit使用的Jira账号拥有以下权限:
- 工单查看权限
- 工单添加评论、关联提交的权限
后续验证步骤
- 重启Gerrit服务器加载新配置。
- 推送一条包含Jira工单号的测试提交到Gerrit,例如commit message写:
PROJ-456: 修复登录逻辑bug。 - 检查Gerrit后台日志(通常在
gerrit_site/logs/error_log),查看是否有its-jira相关的错误信息(如认证失败、API调用报错)。 - 打开对应Jira工单的「开发」标签页,确认是否出现Gerrit提交记录。
内容的提问来源于stack exchange,提问作者AriJang
相关产品推荐
相关产品推荐

