1     簡介

Gerrit，一種免費、開放原始碼的程式碼審查軟體，使用網頁介面。利用網頁瀏覽器，同一個團隊的軟體程式設計師，可以相互審閱彼此修改後的程式程式碼，決定是否能夠提交，退回或者繼續修改。它使用Git作為底層版本控制系統。它分支自Rietveld，作者為Google公司的Shawn Pearce，原先是為了管理Android計劃而產生。這個軟體的名稱，來自於荷蘭設計師赫裡特·裡特費爾德（GerritRietveld）。最早它是由Python寫成，在第二版後，改成用Java與SQL。使用GoogleWeb Toolkit來產生前端的JavaScript。

本次安裝環境如下。

作業系統：CentOS release 6.5 (Final)。

JDK：1.7.0_55

官網安裝手冊（英文版）：

2.1   下載

當前版本為2.9，下載地址：http://code.google.com/p/gerrit/。本文下載的檔案為gerrit-2.9.war，並通過ftp工具上傳至伺服器。

注：此類地址目前國內已被封，可通過其他網站下載或翻牆訪問。

gerrit可以使用H2，PostgreSQL，MySql和Oracle資料庫。本文安裝使用預設H2資料庫。

如使用mysql，需先建立gerrit使用的資料庫和使用者:

mysql

  CREATE USER 'gerrit2'@'localhost' IDENTIFIED BY 'secret';
 

  CREATE DATABASE reviewdb;

  GRANT ALL ON reviewdb.* TO 'gerrit2'@'localhost';

  FLUSH PRIVILEGES;

本文安裝使用root使用者。官網建議為gerrit建立單獨的使用者gerrit2，用於執行gerrit，但是禁止gerrit2使用者登入系統。

# adduser gerrit2

# passwd --delete gerrit2

2.4   安裝

本文安裝使用/usr/local/gerrit作為gerrit site的根目錄。如果使用gerrit2使用者安裝，首先切換到gerrit2使用者，可使用

# sudo su - gerrit2

# java -jar gerrit-2.9.war init -d review

進入互動式安裝,具體的安裝配置如下:

*** Gerrit Code Review 2.8.1

*** 選項中大寫字母為預設選項,如使用預設選項回車即可

Create '/home/gerrit2/review'  [Y/n]?

*** Git Repositories

*** gerrit用於儲存git倉庫的目錄,相對於根目錄review

Location of Git repositories   [git]:

*** SQL Database

***

Database server type           [h2]: 

Server hostname                [localhost]:

Server port                    [(postgresql default)]:

Database name                  [reviewdb]:

Database username              [gerrit2]:

gerrit2's password             :

              confirm password :

*** User Authentication

*** 使用HTTP認證,OPENID需要伺服器連線網際網路,還可以使用LDAP認證服務

Authentication method          [OPENID/?]: http

Get username from custom HTTP header [y/N]?

SSO logout URL                 :

*** Email Delivery

*** gerrit傳送郵件設定,可以使用本地或遠端SMTP伺服器,

*** 只要在smtp伺服器上有帳號即可。

SMTP server hostname           [localhost]: mail.gigasetdigital.com

SMTP server port               [(default)]: 25

SMTP encryption                [NONE/?]:

SMTP username                  [gerrit2]: [email protected]

[email protected]'s password :

              confirm password :

*** Container Process

*** 使用gerrit2使用者執行gerrit

Run as                         [gerrit2]:

Java runtime                   [/usr/java/jdk1.7.0_55/]:

Copy gerrit-2.8.1.war to /home/gerrit2/review/bin/gerrit.war [Y/n]?

Copying gerrit-2.8.1.war to /home/gerrit2/review/bin/gerrit.war

*** SSH Daemon

*** gerrit自帶的ssh服務,與伺服器自身的ssh服務無關,監聽預設埠即可

*** 注意:如要使用低於1024的特權埠,需authbind授權,否則ssh會繫結埠失敗

Listen on address              [*]:

Listen on port                 [29418]:

Gerrit Code Review is not shipped with Bouncy Castle Crypto v144

  If available, Gerrit can take advantage of features

  in the library, but will also function without it.

Download and install it now [Y/n]?

Downloading http://www.bouncycastle.org/download/bcprov-jdk16-144.jar ... OK

Checksum bcprov-jdk16-144.jar OK

Generating SSH host key ... rsa... dsa... done

*** HTTP Daemon

*** 這裡使用nginx反向代理gerrit,所以只在loop介面監聽即可。

*** 如果使用域名訪問gerrit,最好將規範URL設定為域名形式,傳送校驗郵件時會使用到

Behind reverse proxy           [y/N]? y

Proxy uses SSL (https://)      [y/N]?

Subdirectory on proxy server   [/]:

Listen on address              [*]: 

Listen on port                 [8081]:7070

Canonical URL                  [http://127.0.0.1/]:http://192.168.19.16:7070/

*** Plugins

*** 選裝外掛

Install plugin download-commands version v2.8.1 [y/N]?

Install plugin reviewnotes version v2.8.1 [y/N]?

Install plugin replication version v2.8.1 [y/N]?

Install plugin commit-message-length-validator version v2.8.1 [y/N]?

Initialized /home/gerrit2/review

Executing /home/gerrit2/review/bin/gerrit.sh start

Starting Gerrit Code Review:

*** FAILED

*** error: cannot start Gerrit: exit status 1

Waiting for server on 192.168.19.16:7070 ... OK

Opening http://192.168.19.16:7070/#/admin/projects/ ...FAILED

Open Gerrit with a JavaScript capable browser:

http://192.168.19.16:7070/#/admin/projects/

*** 互動式安裝完畢

Gerrit啟動停止命令如下。

review_site/bin/gerrit.sh start

review_site/bin/gerrit.sh stop

review_site/bin/gerrit.sh restart

如要配置開機自啟動服務，修改檔案“review_site/bin/gerrit.sh”，取消以下三行的註釋。

chkconfig: 3 99 99

description: Gerrit Code Review

processname: gerrit

然後，執行以下命令。

sudo ln -snf ~/review_site/bin/gerrit.sh /etc/init.d/gerrit

sudo ln -snf /etc/init.d/gerrit /etc/rc3.d/S90gerrit

至此，Gerrit安裝完成。

3      配置

使用nginx反向代理Gerrit，由nginx承擔http認證，Gerrit不會對使用者進行認證。Gerrit將http認證成功後第一個登入的使用者作為管理員，其他使用者皆為普通使用者，由管理員為其他普通使用者授權。使用者第一次http認證成功後，Gerrit會為使用者生成同名的Gerrit使用者，只要進一步完善賬戶即可。比如新增Email和公鑰。

修改/etc/nginx/nginx.conf，按格式增加以下內容：

# gerrit server

    server {

          listen 7070;

          server_name 192.168.19.16;

          location / {

                auth_basic              "Gerrit2 Code Review";

                auth_basic_user_file    /usr/local/gerrit/etc/htpasswd.conf;

                proxy_pass              http://192.168.19.16:7080;

                proxy_set_header        X-Forwarded-For $remote_addr;

                proxy_set_header        Host $host;

          }

          location /login/ {

                proxy_pass              http://192.168.19.16:7080;

                proxy_set_header        X-Forwarded-For $remote_addr;

                proxy_set_header        Host $host;

          }

        }

使用htpasswd命令為使用者生成http認證配置檔案，如果沒有htpasswd命令需要安裝apache2-utils包。

# htpasswd -d review_site/etc/htpasswd.conf admin

注：以後新增gerrit使用者時，同樣需要先為其配置http認證，使用者登入後gerrit會為其自動生成使用者，賬號與http認證名字一致。