安裝軟體及環境

作業系統win7，使用資料庫gerrit自帶h2，以及apache伺服器

git版本：Git-1.7.8-preview20111206.exe

apache版本：httpd-2.0.64-win32-x86-no_ssl.msi

gerrit版本 ： gerrit-full-2.5.2.war

安裝過程：

這裡為了便於管理，將所有軟體都安裝到D:\git\目錄

安裝好目錄結構如下：

D:\git\gerrit

D:\git\Apache

D:\git\Git

安裝過程注意事項：

在git安裝過程中選擇元件的時候我這裡選擇了

安裝gerrit過程：

將gerrit-full-2.5.2.war 改名為gerrit.war

然後進入命令視窗執行

 java -jar gerrit.war init -d  D:/git/gerrit

前面的建立目錄，git倉庫位置，以及使用資料庫h2，這些都預設即可

Authentication method          [OPENID/?]: 這裡輸入http    我們將使用httpd來對使用者登陸做驗證。

Get username from custom HTTP header [y/N]?
SSO logout URL                 : logout

下面郵件這塊我們一會在進行配置，這裡直接略過

*** Email Delivery
***


SMTP server hostname           [localhost]:
SMTP server port               [(default)]:
SMTP encryption                [NONE/?]:
SMTP username                  :

下面拷貝war包到安裝目錄，不下載外掛。

*** Container Process
***


Run as                         [admin]:
Java runtime                   [C:\Java\jdk1.6.0_14\jre]:
Copy gerrit.war to d:git\gerrit\bin\gerrit.war [Y/n]? 


*** SSH Daemon
***


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]? n
Generating SSH host key ... rsa(simple)... done

Behind reverse proxy           [y/N]?
Use SSL (https://)             [y/N]?
Listen on address              [*]:
Listen on port                 [8080]:


*** Plugins
***


Prompt to install core plugins [y/N]?


Initialized  
Automatic startup not supported on Win32.

到此gerrit安裝完成

Apache伺服器安裝比較簡單，這裡不做詳細介紹，下面重點說配置，這裡是最最核心部分

首先配置apache伺服器：

D:\git\Apache\Apache2\conf目錄下的httpd.conf

大概在159行 去掉下面幾行的#註釋

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
LoadModule negotiation_module modules/mod_negotiation.so

在最後追加下面配置

<VirtualHost 192.168.3.171:8080>          
    ServerName localhost


    ProxyRequests Off
    ProxyVia Off
    ProxyPreserveHost On


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


    <Location /login/>
      AuthType Basic
      AuthName "Gerrit Code Review"
 AuthBasicProvider file     
      AuthUserFile D:/htpasswords
      Require valid-user               
    </Location>


    AllowEncodedSlashes On
    ProxyPass / http://192.168.3.171:8081/
    ProxyPassReverse / http://192.168.3.171:8081/
SetEnv force-proxy-request-1.0.1  
    SetEnv proxy-nokeepalive 1  
</VirtualHost>



下面配置gerrit的配置：

D:\git\gerrit\etc 目錄下的gerrit.config檔案修改成如下

[gerrit]
basePath = git
canonicalWebUrl = http://192.168.3.171:8081/
[database]
type = H2
database = db/ReviewDB
hostname = localhost
[auth]
type = HTTP
[sendemail]
smtpServer = smtp.263.net
smtpServerPort = 25
smtpUser = [email protected]
smtpPass = superscene123456
from = [email protected]
[container]
user = zhjj
javaHome = C:\\Program Files\\jdk\\jre
[sshd]
listenAddress = *:29418
[httpd]
listenUrl = http://192.168.3.171:8081/
[cache]
directory = cache

注意上面的smtp設定，按照實際情況填寫。



這裡需要特別指出的是apache的埠和gerrit的埠是不同的，使用者訪問地址為apache的地址

其中htpasswd檔案使用apache的htpasswd.exe建立，並新增使用者，不會的可以上網查查

htpasswd [c] /home/svnroot/repository/authfile username password

htpasswd  D:\Users\Tommy\htpasswd xiaoming

htpasswd D:\Users\Tommy\htpasswd xiaoniu

關於啟動，

啟動gerrit

gerrit\bin>gerrit.sh start

這裡一般的來說都提示啟動失敗

Starting Gerrit Code Review: FAILED

別害怕，一般的來說都是成功的，等一會就好了。

啟動apache服務，然後訪問apache服務，輸入htpasswd中的賬號和密碼即可登入成功。

關於使用：

首先訪問apache伺服器，我這裡的地址是 http://10.14.132.179:8080/

在彈出的輸入框中輸入賬號密碼，點選登入即可，有時候由於重定向等問題會出現一個配置錯誤的頁面，這時只需要將再一次訪問登入地址即可。

登入成功後點擊右上角的Settings連結，然後點選Contact Information，對使用者名稱進行配置

設定郵箱的時候可能會遇到拒絕訪問的錯誤，這多半是smtp伺服器設定有誤，導致不能給使用者傳送郵件。

第一個成功登陸系統的使用者即為管理員，可以通過點選Groups來檢視當前使用者擁有的所有角色。

點選Projects下的Create New Project可以建立一個新的專案

All-Projects 這個是專案許可權模板，其他專案可以直接繼承這個專案的許可權設定。

點選新建立的專案，點選Access可以對專案做許可權設定。

有些許可權配置管理員可能也會碰到許可權不足的情況，這時候可以指定一個專案的Owner，用Owner賬戶來做許可權設定即可。

點選SSH Public Keys 對ssh key進行配置。可以在命令列下通過ssh-keygen -t rsa (或ssh-keygen -t rsa -C "zhjj”) 命令生成金鑰，

然後將C:\Users\username\.ssh下的id_rsa.pub檔案裡面所有內容複製到那個輸入框裡面即可，注意：所有內容都複製進去。

ssh -p 29418 username@10.14.132.179 

來驗證是否能通過ssh訪問gerrit伺服器。注意如果伺服器重新安裝後可能會引起客戶端儲存的伺服器驗證不正確，此時只要刪除C:\Users\username\.ssh下的known_hosts即可。

（如前端預設註冊郵箱報500錯誤可使用命令列註冊）

通過gerrit set-account修改

如果你gerrit伺服器所在環境傳送郵件有困難，那麼你可以選擇通過管理遠端設定/修改gerrit使用者的郵箱地址。命令如下，用該方法設定/修改email，方便快捷，而且能夠立即生效（rsa公鑰的檢測，如果.ssh資料夾下的id_rsa.pub公鑰內容沒有註冊到當前gerrit賬戶publickey中，會提醒Permission denied (publickey)）

（連線的gerrit登入使用者名稱@地址）（郵箱、gerrit登入使用者名稱）

設定git賬戶的使用者名稱和郵箱

git config --global user.name "username"  
git config --global user.email [email protected]

通過git clone ssh://[email protected]:29418/work

將程式碼下載到本地，然後修改，然後提交

git status  --檢視狀態

git add .

git commit -m "這裡是註釋"

//將預設提交到分支裡面

git config remote.origin.push refs/heads/*:refs/for/*

向伺服器推送程式碼

git push origin