Gerrit 2.14入门指南

港控/mmm° 2022-06-16 01:36 292阅读 0赞

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/即可。