Gerrit code review与GitWeb在window7环境上的安装配置

写本文的目的是为了方便在windows环境下能够布署上Gerrit代码评审环境和GitWeb实现代码管理，并总结本人在安装中所遇到的问题，以使后来者少走弯路，如果是在linux环境下配置就可以略过了。

工欲善其事必先利其器，先准备好要用的软件

Git的下载地址：http://code.google.com/p/msysgit/downloads/list Git-1.8.4-preview20130916.exe

gerrit 的下载地址：http://code.google.com/p/gerrit/ gerrit-2.8.war

Apache的下载地址：http://httpd.apache.org/download.cgi httpd-2.2.25-win32-x86-openssl-0.9.8y.msi

Mysql的下载地址：http://www.mysql.com/downloads/ mysql-5.5.34-win32.msi

tomcat7的下载地址：http://tomcat.apache.org/download-70.cgi apache-tomcat-7.0.47.zip

下载jdk jdk-6u35-windows-i586.exe

以上是所需要用到的软件，下面开始安装了，安装目录的安排如下：（根据自己需要）

E:\GitServer\

E:\GitServer\Apache

E:\GitServer\gerrit

E:\GitServer\Git

E:\GitServer\Tomcat7

1、首先安装Git,我在安装时的选择







在Git中没有CGI模块，因此不能正确启动GitWeb脚本，因此要先下载CGI模块 http://search.cpan.org/~markstos/CGI/，下一个CGI3.59版本，把里面的lib文件夹里的文件拷到E:\GitServer\Git\lib\perl5\5.8.8目录下。

在E:\GitServer\Git\share\gitweb目录下找到gitweb.cgi用UE打开修改

our $GIT = "E:/GitServer/Git/bin/git";

our $projectroot = "/E/XXXXXX/XXXXXXX"; 这个是Git代码的项目目录

2、Apache、MySQL、JDK的安装，直接安照向导安装就可以了，这里就不贴图了。

3、Gerrit的安装,首先在mysql中建好reviewdb数据库

CREATE USER
'gerrit'@'localhost' IDENTIFIED BY 'gerrit';

CREATE DATABASE reviewdb;

ALTER DATABASE reviewdb charset=latin1;

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

FLUSH PRIVILEGES;

脚本的意思是建一个reviewdb的数据库并给它gerrit用户名和密码来管理

打开命令行cmd,将gerrit-2.8.war放在E:\GitServer\下，java -jar gerrit-2.8.war init -d E:/GitServer/gerrit/review_site





后面就提示安装完成，然后不能在win32下运行，这个提示不要紧，我们的gerrit不是用它自带的jetty服务器而是tomcat和apache,下面是我的gerrit配置文件，在review_site\etc下找到gerrit.config文件，就可以编辑它，根据需要把一些配置改过来

[gerrit]

basePath = E:/GitStack/repositories 这个是git仓库的位置

canonicalWebUrl = http://192.168.1.100:8080/gerrit/ 这是gerrit的起始链接

[gitweb]

url = http://192.168.1.100:81/gitweb 这是gitweb查看的链接

[database] mysql的一些信息

type = mysql

hostname = localhost

port = 3306

database = reviewdb

username = gerrit

[auth]

type = HTTP

logoutUrl = http://admin:admin@192.168.1.100:8080/
[sendemail] 注册发确认邮件配置

smtpServer = smtp.qq.com

smtpServerPort = 465

smtpEncryption = SSL

smtpUser = xxxxxxxxx@qq.com

smtpPass = xxxxxxxxx

from = Code Review <xxxxxxxx@qq.com>

[container]

user = admin

javaHome = C:\\jdk1.6\\jre

[sshd]

listenAddress = *:29418

[httpd]

listenUrl = proxy-http://192.168.1.100:8080/ 监听的链接用于apache反向连接

[cache]

directory = cache

把gerrit-2.8.war改为gerrit-2.8.zip,并解压到E:\GitServer\gerrit\gerrit-2.8里面，这是tomcat来作为服务器运行这个web

4、将tomcat7解压到E:\GitServer\Tomcat7下， 然后在tomcat7\conf\Catalina\localhost下建一个文件gerrit.xml内容是

<?xml version="1.0" encoding="utf-8"?>
<Context path="/gerrit" docBase="E:/GitServer/gerrit/gerrit-2.8" reloadable="true"/>

接着修改tomcat7\conf下context.xml,在<context>中加入如下代码

<Resource
name="jdbc/ReviewDb"
type="javax.sql.DataSource"
driverClassName="com.mysql.jdbc.Driver"
username="gerrit"
password="gerrit"
maxIdle="30"
maxWait="10000"
maxActive="100"
url="jdbc:mysql://localhost:3306/ReviewDB?autoReconnect=true"
auth="Container"
/>

5、配置Apache:将Apache\Apache2\conf\http.conf里如下地方前面的#号去掉表示启用功能

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

在最后面加上

Include conf/extra/httpd-git.conf

Include conf/extra/httpd-gerrit.conf

在Listen 80后加上Listen 81，这个81用来访问gitweb

在conf/extra目录下新建如上两个配置文件内容如下

http-git.conf GIT_PROJECT_ROOT 的路径和E:\GitServer\Git\share\gitweb\gitweb.cgi 里的 our $projectroot = "/E/XXXXXX/XXXXXXX";一致

AuthUserFile "E:/GitServer/Git/htpassword" 这个文件通过Aapche\bin\htpasswd.exe 创建，如：htpasswd -c E:\GitServer\Git\htpassword admin

<VirtualHost *:81>
SetEnv GIT_PROJECT_ROOT "E:/XXXXXXXXX/XXXXXXXX"
SetEnv GIT_HTTP_EXPORT_ALL 1
ScriptAlias /repos "E:/GitServer/Git/libexec/git-core/git-http-backend.exe/"
<Directory "E:/GitServer/Git/libexec/git-core/">
Allow From All
</Directory>
<Location "/repos">
Order Allow,Deny
Allow from all
AuthType Basic
AuthName "GIT Repository"
AuthUserFile "E:/GitServer/Git/htpassword"
Require valid-user
</Location>
Alias /gitweb "E:/GitServer/Git/share/gitweb"
<Directory "E:/GitServer/Git/share/gitweb">
AddHandler cgi-script .cgi
<Files ~ "\.cgi$">
Options +ExecCGI
</Files>
AllowOverride None
Order allow,deny
Allow from all
DirectoryIndex gitweb.cgi
</Directory>
ErrorLog "E:/GitServer/Apache/Apache2/logs/gitweb_error.log"
CustomLog "E:/GitServer/Apache/Apache2/logs/gitweb_access.log" common
</VirtualHost>

httpd-gerrit.conf

<VirtualHost *:80>
ServerName 填你的域名/IP
ProxyRequests Off
ProxyVia Off
ProxyPreserveHost On
ErrorLog E:/GitServer/Apache/Apache2/logs/gerrit_error.log

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

<Location /gerrit/login/>
AuthType Basic
AuthName "Gerrit Android Code Review"
AuthBasicProvider file
Require valid-user
AuthUserFile E:/GitServer/Git/htpassword
</Location>

AllowEncodedSlashes On
ProxyPass / http://192.168.1.100:8080/ nocanon
ProxyPassReverse / http://192.168.1.100:8080/ nocanon
SetEnv force-proxy-request-1.0 1
SetEnv proxy-nokeepalive 1
</VirtualHost>

有以上的配置步骤然后启动tomcat和apcahe基本上gerrit和gitweb就已经可以运行起来了，通过http://localhost/gerrit/login/ 就可以来登录了，由于这里gerrit是用的htttp认证方式，用户帐号都是在htpassword里的，要添加用户就在htpassword里面加，第一个登录gerrit的帐号自动成为管理员，因此在登录进后最好马上修改用户名和验证邮箱，不然再次登录的时候就没有管理员的权限，不能创建项目和管理组了，如果出现这个情况就只有直接去mysql里修改数据库了如下图：



还有一个问题大家会遇到就是有多层目录的时候，浏览时会报Error Bad Request,这是因为tomcat对"/"的解析有问题，此时要在tomcat/bin/catalina.bat里要加上-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true，还有如果库的代码很大的话，在浏览时会报500的错误，这是java的虚拟内存不够用，解决办法还是修改catalina.bat加上-Xmx800m，因此总的解决办法就来了，在它里面加上set
JAVA_OPTS=-server -Xms800m -Xmx800m -XX:MaxNewSize=256m -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true，同时解决这两个问题。





以上就是我在安装Gerrit时的经验