如何搭建開源code review gerrit服務器

搭建環境：Ubuntu 14.04

1、環境準備

1.Java環境

gerrit依賴，用於安裝gerrit環境。

下載：jdk-7u79-linux-x64.tar.gz http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

安裝：sudo tar zxvf ./jdk-7u79-linux-x64.tar.gz -C /opt

配置：vim ~/.bashrc(針對當前用戶) or vim /etc/profile(針對全部用戶，推薦)

export JAVA_HOME=/opt/jdk1.7.0_79
export JRE_HOME=$JAVA_HOME/jre
export CLASSPATH=$JAVA_HOME/lib:$JRE_HOME/lib:$CLASSPATH
export PATH=$JAVA_HOME/bin:$JRE_HOME/bin:$PATH

驗證：java -version

java version "1.7.0_79"
Java(TM) SE Runtime Environment (build 1.7.0_79-b15)
Java HotSpot(TM) 64-Bit Server VM (build 24.79-b02, mixed mode)

2.git環境

gerrit依賴，用來操做git repository。

安裝：sudo apt-get install git

驗證：git --version

git version 1.9.1

3.gerrit環境

下載：Gerrit 2.12.4 https://www.gerritcodereview.com/download/gerrit-2.12.4.war

4.apache2環境

安裝：sudo apt-get install apache2 

驗證：sudo /etc/init.d/apache2 start

5.gerrit管理賬號(可選，使用獨立帳號配置gerrit)

gerrit依賴，用來管理gerrit。

sudo adduser gerrit

sudo passwd gerrit

並將gerrit加入sudo權限

sudo visudo

gerrit  ALL=(ALL:ALL) ALL

2、安裝與配置gerrit

1.配置gerrit

默認安裝：java -jar gerrit-2.12.4.war init --batch -d ~/review_site

更新配置文件：sudo vim ~/review_site/etc/gerrit.config

[gerrit]
        basePath = git #默認gerrit對應的git庫
        canonicalWebUrl = http://192.168.199.112:8081/ #gerrit web管理界面
[database]
        type = h2 #h2數據庫
        database = db/ReviewDB #數據庫路徑
[index]
        type = LUCENE
[auth]
        type = HTTP #auth模式，默認爲OPENID，配置爲HTTP，須要apache配置反向代理
[receive]
        enableSignedPush = false
[sendemail]
　　　　 enable=false #關閉郵件提醒
[container]
        user = gerrit #linux user for gerrit
        javaHome = /opt/jdk1.7.0_79/jre #java home
[sshd]
        listenAddress = *:29418 #default gerrit port
[httpd]
        listenUrl = http://*:8081/
[cache]
        directory = cache
[http]
        proxy = http://192.168.199.112:8080 #proxy server
        proxyUsername = gerrit1 #proxy user & password
        proxyPassword = 123456

2.配置apache2反向代理

• 若是apache目錄結構以下：

[username@hostname apache2]$ ls 
apache2.conf conf-enabled magic mods-enabled ports.conf sites-enabled conf-available envvars mods-available sites-available

開啓SSL、Proxy、Rewrite等模塊：

cd /etc/apache2/mods-enabled
ln -s ../mods-available/proxy.load
ln -s ../mods-available/proxy.conf
ln -s ../mods-available/proxy_http.load
ln -s ../mods-available/proxy_balancer.conf
ln -s ../mods-available/proxy_balancer.load
ln -s ../mods-available/rewrite.load
ln -s ../mods-available/ssl.conf
ln -s ../mods-available/ssl.load
ln -s ../mods-available/socache_shmcb.load #
ln -s ../mods-available/slotmem_shm.load #

更新配置文件：sudo vim /etc/apache2/sites-enabled/gerrit-httpd.conf

ServerName 192.168.199.112 #your server ip
<VirtualHost *:8080>
    ProxyRequests Off
    ProxyVia Off
    ProxyPreserveHost On
    AllowEncodedSlashes On
    RewriteEngine On
    RewriteRule ^/(.*) http://192.168.199.112:8081/$1 [NE,P] #rewrite rule for proxy

    <Proxy *>
          Order deny,allow
          Allow from all
    </Proxy>

    <Location /login/>
        AuthType Basic
        AuthName "Gerrit Code Review"
        Require valid-user
        AuthBasicProvider file
        AuthUserFile /etc/apache2/passwords #password file for gerrit
    </Location>

    ProxyPass / http://192.168.199.112:8081/

</VirtualHost>

• 若是apache目錄結構以下：

[username@hostname apache2]$ ls
bin  build  cgi-bin  conf  error  htdocs  icons  include  lib  logs  man  manual  modules

開啓SSL、Proxy、Rewrite等模塊：

[username@hostname apache2]$ vi conf/http.conf

# Open LoadModule
LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule ssl_module modules/mod_ssl.so LoadModule rewrite_module modules/mod_rewrite.so # Gerrit config Include conf/extra/gerrit-httpd.conf 

其中apache2/conf/extra/gerrit-httpd.conf內容同上，apache2/sites-enabled/gerrit-httpd.conf。

3.配置gerrit帳戶密碼

touch /etc/apache2/passwords

htpasswd -b /etc/apache2/passwords admin 123456(管理員)

htpasswd -b /etc/apache2/passwords gerrit1 123456(普通用戶)

4.啓動gerrit&啓動apache2

sudo ~/review_site/bin/gerrit.sh start

sudo /etc/init.d/apache2 start

5.訪問gerrit 管理界面 http://192.168.199.112:8080/

第一次訪問，須要輸入第3步設置的admin及密碼，該帳戶將做爲gerrit管理員帳戶。進入後可設置FullName: GerritAdmin。

 

 

3、如何使用gerrit

前提：須要git使用端 / gerrit服務端配合使用。

1.添加項目(gerrit 服務端)

1.1使用gerrit添加新項目：（適用於開啓新項目並使用gerrit）

ssh -p 29418 gerrit1@192.168.199.112 gerrit create-project --empty-commit --name demo-project #建議採用管理界面添加

或者使用gerrit管理界面

1.2使用gerrit添加已有項目：（適用於已有項目下移植到gerrit中）

ssh -p 29418 gerrit1@192.168.199.112 gerrit create-project --name exist-project #建議採用管理界面添加

或者使用gerrit管理界面

而後將已有項目與gerrit上創建的exist-project關聯，即將已有代碼庫代碼push到gerrit中進行管理。

cd ~/gitcode/exist-project

git push ssh://gerrit1@192.168.199.112:29418/exist-project *:*

2.生成sshkey(git使用端)

在開發帳戶中生成sshkey，用做與gerrit服務器鏈接。

ssh-keygen -t rsa #生成sshkey

ls ~/.ssh/ #可查看sshkey

cat ~/.ssh/id_rsa.pub #查看sshkey

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCj1XDqjNXbn39oeacJOxe8FklBJRpGS1CcHRThWBytZ4A5KXAaxYzcD94GUd9UxxZzKCr6y90mwuJ+jkKxCTlqUiwj73QIiPWQ3Re08M049W4XxdfGnu/jyTI9DptWBsF0dwFJlQquUtitS+b1Tkz7Jr7+WipbZ22aiHwRvY4VcvCCdIHy/BnCCbVcfgk9u8f+X+ROm+DkOGfUcBNXWEJydqF0wy/D13Q5gp9OAXMIOD05T3GToJRwYtx2cVFmK4jE9HtcudOrrZNFVHqeblbA7EMKpIuDpLho7esmpwJ/woB1wnKTwHoUzbMt0a6hHPMNWyP2WIJebEA1KzThLixt gerrit@RylanYan-ThinkPad

3.添加sshkey到gerrit服務器(gerrit 服務端)

此步驟與git流程相似，即將id_rsa.pub內容上傳到git repository，gerrit中幫咱們管理git repository.

 

4.拉取代碼＆配置git hooks(git client端)

驗證sshkey是否配置成功：ssh gerrit1@192.168.199.112 -p 29418

The authenticity of host '[192.168.199.112]:29418 ([127.0.0.1]:29418)' can't be established.
  RSA key fingerprint is db:07:3d:c2:94:25:b5:8d:ac:bc:b5:9e:2f:95:5f:4a.
  Are you sure you want to continue connecting (yes/no)? yes
  Warning: Permanently added '[192.168.199.112]:29418' (RSA) to the list of known hosts.

  ****    Welcome to Gerrit Code Review    ****

  Hi user, you have successfully connected over SSH.

  Unfortunately, interactive shells are disabled.
  To clone a hosted Git repository, use:

  git clone ssh://gerrit1@192.168.199.112:29418/REPOSITORY_NAME.git

拉取代碼： git clone ssh://gerrit1@192.168.199.112:29418/demo-project

更新githooks：gitdir=$(git rev-parse --git-dir); scp -p -P 29418 gerrit1@192.168.199.112:hooks/commit-msg ${gitdir}/hooks/

該過程用來在commit-msg中加入change-id，gerrit流程必備。

修改代碼並提交，推送時與原有git流程不一致，採用 git push origin HEAD:refs/for/master 。

git push origin HEAD:refs/for/master
Counting objects: 6, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 381 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote: Processing changes: new: 1, refs: 1, done    
remote: 
remote: New Changes:
remote:   http://localhost:8081/4 Append date to testfile
remote: 
To ssh://gerrit1@localhost:29418/demo-project
 * [new branch]      HEAD -> refs/for/master

 

五.使用gerrit website完成code review

當完成push後，可在gerrit管理界面看到當前提交code review的change。

查看須要code review的提交：

查看某次提交的詳細信息（審覈者+2可經過本次提交，提交者可經過Abandon本次提交）：

若是審覈者+2經過後，可提交該次commit.

六.gerrit注意事項

* 須要爲每一個使用者分配gerrit帳號，不要都使用admin帳號，由於admin帳號可直接push master

* pull代碼後須要配置githooks文件，以便在commit時自動生成change-id，不然沒法push

* push代碼時須要使用git push origin HEAD:refs/for/master(branch),gerrit默認關閉非admin帳號的push direct權限

* push代碼時須要commit email與gerrit account email一致，不然沒法push成功，可選擇關閉email notify，並開啓forge user權限，或者經過修改gerrit數據庫account email信息

* gerrit數據庫與gitlab同步，須要安裝replication插件，並開啓該功能 參考：http://www.cnblogs.com/tesky0125/p/5973642.html

 

 

參考連接：

Java SDK Download: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

Gerrit Code Review - Releases Download: https://gerrit-releases.storage.googleapis.com/index.html

Gerrit Code Review -  Quick get started guide: https://git.eclipse.org/r/Documentation/install-quick.html

Gerrit代碼審覈服務器搭建全過程 http://blog.csdn.net/ganshuyu/article/details/8978614

Gerrit代碼審覈流程 http://www.worldhello.net/gotgit/images/gerrit-workflow.png

Gerrit代碼審覈原理 http://www.worldhello.net/gotgit/05-git-server/055-gerrit.html

Gerrit代碼審覈權限管理 https://gerrit-review.googlesource.com/Documentation/access-control.html#category_forge_committer

Gerrit修改數據庫email信息 http://www.cnblogs.com/kevingrace/p/5624122.html

Gerrit安裝replication插件 https://gerrit-review.googlesource.com/Documentation/cmd-plugin-install.html