什么是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 SMTP_FROM=ndf.monitor@xiaoniu66.com \
-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 SMTP_FROM=ndf.monitor@xiaoniu66.com \
-d openfrontier/gerrit
注意:
如果直接docker rm -f gerrit这个docker服务,重启时,会出现数据库错误。这时需要docker rm -f pg-gerrit数据库服务,重新启动数据库服务后再启动gerrit服务即可恢复;