Gerrit是一款免费、开源的代码审查和代码库管理的软件,以Git代码库作为版本控制系统,可以通过命令行、REST和网页界面进行访问。
1.版本
截至2017年5月,最新版本2.14。
2.下载链接
https://gerrit-releases.storage.googleapis.com/gerrit-2.14.war
3.安装
java -jar ~/gerrit-2.14.war init -d ~/myGerritSite
注意,~/myGerritSite为安装路径。
安装过程中的配置参数如下:
- Location of Git repositories, 默认git
- Database server type,默认H2
- Authentication method,默认OPENID
- Run as,默认当前用户
- Java runtime, JRE的路径
- SSH Daemon
- Listen on address, 默认*
- Listen on port, Gerrit SSH监听端口默认29418
- HTTP Daemon
- Behind reverse proxy,默认y
- Use SSL, 默认y
- Listen on address, 默认*
- Listen on port, Gerrit Web监听端口默认8888
4.Gerrit安装内容
安装完毕,默认设置环境变量如下:
- $site_path=~/myGerritSite
- gerrit.basePath=$site_path/git/
- ...
Gerrit的安装目录,即$site_path,主要包括两类文件,一类是Gerrit元数据文件,另一类是Git库数据文件。
1) Gerrit元数据又分为如下文件:
- 配置文件$site_path/etc/gerrit.config
- H2数据文件
- 服务器的SSH keys文件
查看Gerrit配置文件如下:
[gerrit]
basePath = git
canonicalWebUrl = http://gerrit.server
[auth]
type = HTTP
[container]
user = gerritadmin
javaHome = /opt/jdk1.6.0_38/jre
[sshd]
listenAddress = *:29418
[httpd]
listenUrl = proxy-http://localhost:8888/
[cache]
directory = cache
2) Git库数据文件默认位于$site_path/git/。
如果要改变Git库,使用其他Git库,需要执行如下命令:
- 初始化Git库
git --git-dir=$my_path/new/myproject.git init
- 创建git-daemon-export-ok文件,以支持匿名访问
touch $base_path/new/myproject.git/git-daemon-export-ok
- 重启Gerrit服务器,或者flush project_list cache,以注册Git库
ssh -p 29418 localhost gerrit flush-caches --cache project_list
5.Gerrit的Web服务器默认采用嵌入到Jetty,停启Web服务器命令如下:
~/myGerritSite/bin/gerrit.sh start
~/myGerritSite/bin/gerrit.sh stop
~/myGerritSite/bin/gerrit.sh restart
打开浏览器就可以访问http://localhost:8888/即可。