代码托管及评审工具gerrit

什么是gerrit

gerrit是google开发的集成git和代码评审的工具（google最重要的实践之一就是代码评审）。
世界上第二大的开源体openstack就是使用作为代码评审。

安装部署

采用docker方式进行安装。
gerrit镜像选择的是：
https://hub.docker.com/r/openfrontier/gerrit/

采用本地文件夹存储数据

docker run \
--name gerrit \
-p 8088:8080 \
-p 29418:29418 \
-e WEBURL=http://10.17.2.178:8088 \
-e AUTH_TYPE=LDAP \
-e LDAP_SERVER=ldap://10.10.43.66:389  \
-e LDAP_ACCOUNTBASE=ou=小牛资本管理集团,dc=xiaoniu,dc=com \
-e LDAP_USERNAME=cn=gitlab,ou=Special,dc=xiaoniu,dc=com \
-e LDAP_PASSWORD=git-ladp \
-e GERRIT_INIT_ARGS='--install-all-plugins' \
-v ~/gerrit_volume:/var/gerrit/review_site \
-e SMTP_SERVER=10.8.42.101 \
-e SMTP_SERVER_PORT=25 \
-e SMTP_USER=ndf.monitor \
-e SMTP_PASS=Qaz1wsx#xn \
-e SMTP_CONNECT_TIMEOUT=10sec \
-e [email protected] \
-d openfrontier/gerrit

注意：

• WEBURL如果不填写，登录用户后会跳转不成功；
• 该gerrit镜像默认安装很少插件，使用--install-all-plugins会安装core类型的所有插件（不是gerrit所有的插件）
• 填写发邮件功能，评委才能收到评审的通知

（使用docker logs -f gerrit可以查看gerrit服务日志情况）

使用

推荐安装gitreview
sudo yum install gitreview
在项目根目录下，新增 .gitreview文件
内容参考如下：

[gerrit]
host=10.17.2.178
port=29418
project=TtsResult2ES
defaultbranch=master

新增gitreview的用户名
git config --global --add gitreview.username "xn080520"

即可直接用git-review取代git push origin HEAD:refs/for/master的操作

管理员操作

创建一个母项目
create projects时，勾选Only serve as parent for other projects
创建后，可以edit config，例如：

[label "Verified"]
    value = -1 Fails
    value =  0 No score
    value = +1 Verified
    defaultValue = 0
[access]
        inheritFrom = All-Projects
[access "refs/*"]
        owner = group OpsDev
        read = group OpsDev
        labelAs-Code-Review = -2..+2 group OpsDev
        label-Verified = -1..+1 group OpsDev
[access "refs/heads/*"]
        push = group OpsDev
        label-Workflow = -1..+1 group OpsDev
        submit = group OpsDev
[access "refs/heads/feature/*"]
        create = group OpsDev
        push = group OpsDev

注意：这时你是无法发布成功的，即使groups中你已经加了OpsDev这个组
可以在代码评审界面add一个文件叫groups
里面有OpsDev的UUID定义，内容举例为(UUID和名称之间用tab隔开）：
662bc9ea4ca24ab6abe8ceea6dcea820785b05a4 OpsDev
这样才能正确识别组名并发布成功。

新的项目，继承这个母项目，就不需要重新配置权限等操作了。

附录

如果gerrit数据采用postgre取代自带的h2数据库，可以采用如下方式：
内容采用docker化的数据库postgre进行存储
https://hub.docker.com/_/postgres/

启动数据库：

docker run \
--name pg-gerrit \
-p 5432:5432 \
-e POSTGRES_USER=gerrit2 \
-e POSTGRES_PASSWORD=gerrit \
-e POSTGRES_DB=reviewdb \
-d postgres

启动gerrit服务

docker run \
--name gerrit \
--link pg-gerrit:db \
-p 8088:8080 \
-p 29418:29418 \
-e WEBURL=http://10.17.2.178:8088 \
-e AUTH_TYPE=LDAP \
-e LDAP_SERVER=ldap://10.10.43.66:389  \
-e LDAP_ACCOUNTBASE=ou=小牛资本管理集团,dc=xiaoniu,dc=com \
-e LDAP_USERNAME=cn=gitlab,ou=Special,dc=xiaoniu,dc=com \
-e LDAP_PASSWORD=git-ladp \
-e DATABASE_TYPE=postgresql \
-e GERRIT_INIT_ARGS='--install-all-plugins' \
-e SMTP_SERVER=10.8.42.101 \
-e SMTP_SERVER_PORT=25 \
-e SMTP_USER=ndf.monitor \
-e SMTP_PASS=Qaz1wsx#xn \
-e SMTP_CONNECT_TIMEOUT=10sec \
-e [email protected] \
-d openfrontier/gerrit

注意：
如果直接docker rm -f gerrit这个docker服务，重启时，会出现数据库错误。这时需要docker rm -f pg-gerrit数据库服务，重新启动数据库服务后再启动gerrit服务即可恢复；