Gerrit 3.8+版本GitHub插件集成配置方法求助

一、GitHub 侧前置准备 #

• 生成个人访问令牌（PAT）：需要勾选 repo、admin:repo_hook 权限，确保能访问目标仓库并配置钩子
• 确认你对目标GitHub仓库拥有读写权限

二、Gerrit 插件基础配置 #

• 验证插件状态：进入Gerrit后台的Plugins页面，确认GitHub插件处于启用状态
• 修改Gerrit核心配置文件 gerrit.config，添加以下配置块：

[plugin "github"]
  url = https://api.github.com
  token = <你的GitHub PAT令牌>
  # 可选：设置默认GitHub用户名/组织，简化后续仓库关联操作
  defaultOwner = <你的GitHub用户名或组织名>

• 重启Gerrit服务，使配置生效

三、关联GitHub仓库到Gerrit #

1. 进入Gerrit的Projects页面，点击Create Project
2. 选择Import project选项，在来源列表中选择GitHub
3. 插件会自动拉取PAT权限范围内的GitHub仓库列表，选择需要关联的仓库
4. 填写Gerrit侧的项目名称（建议与GitHub仓库同名），完成导入
5. 导入完成后，Gerrit会自动拉取GitHub仓库的代码，建立基础关联

四、代码同步配置 #

• 自动同步：进入项目的Settings页面，找到GitHub Integration选项，启用Auto-sync after merge，指定需要同步的分支（如main、master），后续Gerrit合并变更后会自动同步到GitHub对应分支
• 手动同步：在项目页面的GitHub标签页，点击Sync Now按钮，可手动触发Gerrit与GitHub仓库的代码同步

五、常见问题排查 #

• 无法加载GitHub仓库列表：检查PAT权限是否完整，Gerrit服务器是否能正常访问GitHub API
• 同步失败：查看Gerrit日志目录下的error_log文件，排查认证错误或权限不足问题
• 插件功能异常：确认GitHub插件版本与Gerrit 3.8+版本兼容，建议使用对应版本的稳定版插件

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