首页 > 代码库 > Gerrit 代码审核服务器的工作流和原理
Gerrit 代码审核服务器的工作流和原理
Gerrit 代码审核服务器的工作流和原理
谷歌 Android 开源项目在 Git 的使用上有两个重要的创新,一个是为多版本库协同而引入的 repo,这在之前我们已经详细讨论过。另外一个重要的创新就是 Gerrit —— 代码审核服务器。Gerrit 为 Git 引入的代码审核是强制性的,就是说除非特别的授权设置,向 Git 版本库的推送(Push)必须要经过 Gerrit 服务器,修订必须经过代码审核的一套工作流之后,才可能经批准并纳入正式代码库中...
6.7 Gerrit 代码审核服务器
首先贡献者的代码通过 git 命令(或 repo 封装)推送到 Gerrit 管理下的 Git 版本库,推送的提交转化为一个一个的代码审核任务,审核任务可以通过 refs/changes/<change-id> 下的引用访问到。代码审核者可以通过 Web 界面查看审核任务、代码变更,通过 Web 界面做出通过代码审核或者打回等决定。测试者也可以通过 refs/changes/<change-id> 引用获取(fetch)修订对其进行测试,如果测试通过就可以将该评审任务设置为校验通过(verified)。最后经过了审核和校验的修订可以通过 Gerrit 界面中提交动作合并到版本库对应的分支中。 在 Android 项目的网站的代码贡献流程图更为详细的介绍了 Gerrit 代码审核服务器的工作流程。代码审核工作流
6.7.1 Gerrit 的实现原理
SSH 协议的 Git 服务器 Gerrit 本身基于 SSH 协议实现了一套 Git 服务器,这样就可以对 Git 数据推送进行更为精确的控制,为强制审核的实现建立了基础。 Gerrit 提供的 Git 服务的端口并非标准的 22 端口,缺省是 29418 端口。可以访问 Gerrit 的 Web 界面得到这个端口。对 Android 项目的代码审核服务器,访问 https://review.source.android.com/ssh_info 就可以查看到 Git 服务的服务器域名和开放的端口。下面我们用 curl 命令查看网页的输出。$ curl -L -k http://review.source.android.com/ssh_info review.source.android.com 29418特殊引用 refs/for/<branch-name> 和 refs/changes/nn/<task-id>/m Gerrit 的 Git 服务器,禁止用户向 refs/heads命名空间下的引用执行推送(除非特别的授权),即不允许用户直接向分支进行提交。为了开发者能够向 Git 服务器提交修订,Gerrit 的 Git 服务器只允许用户向特殊的引用 refs/for/<branch-name> 下执行推送,其中 <branch-name> 即为开发者的工作分支。向 refs/for/<branch-name> 命名空间下推送并不会在其中创建引用,而是为新的提交分配一个 ID,称为 task-id ,并为该 task-id 的访问建立如下格式的引用 refs/changes/nn/<task-id>/m ,其中:
- task-id 为 Gerrit 为评审任务顺序分配的全局唯一的号码。
- nn 为 task-id 的后两位数,位数不足用零补齐。即 nn 为 task-id 除以 100 的余数。
- m 为修订号,该 task-id 的首次提交修订号为 1,如果该修订被打回,重新提交修订号会自增。
Android 项目代码审核网站
Android 项目的评审网站,匿名即可访问。点击菜单中的 “Merged” 显示了已经通过评审合并到代码库中的审核任务。下面的一个界面就是 Andorid 一个已经合并到代码库中的历史评审任务。
Android 项目的 16993 号评审
在该界面我们可以看到:- URL 中显示的评审任务编号为 16993。
- 该评审任务的 Change-Id 以字母 I 开头,包含了一个唯一的 40 位 SHA1 哈希。
- 整个评审任务有三个人参与,一个人进行了检查(verify),两个人进行了代码审核。
- 该评审任务的状态为已合并:“merged”。
- 该评审任务总共包含两个补丁集: Patch set 1 和 Patch set 2。
- 补丁集的下载方法是: repo download platform/sdk 16993/2 。
$ git ls-remote ssh://review.source.android.com:29418/platform/sdk refs/changes/93/16993* 5fb1e79b01166f5192f11c5f509cf51f06ab023d refs/changes/93/16993/1 d342ef5b41f07c0202bc26e2bfff745b7c86d5a7 refs/changes/93/16993/2接下来我们就来介绍一下 Gerrit 服务器的部署和使用方法。
Gerrit 代码审核服务器的工作流和原理
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。