Gerrit的安装和使用说明

Gerrit安装和使用说明

搞了几天，资料也查了不少，终于磨出来了。有什么不对的地方，大家及时提出来。。。，开始吧

系统	Centos6.5 x64
内存	2G
硬盘	20G
数据库	Mysql5.1
服务器	Apache2.2

准备

#yum update

#yum install git

#yum install java-1.7.0-openjdk.x86_64

#yum install mysql-server

#service mysqld start

配置mysql

#mysql –u root

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

-> CREATE DATABASE reviewdb;

-> ALTER DATABASE reviewdb charset=latin1;

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

-> FLUSH PRIVILEGES;

安装gerrit

安装文件见【附件】

1)一直选择默认enter（只有在选择数据库时选择mysql，在选择验证方式时选http）

#java -jar gerrit-full-2.5.war init -d /var/gerrit-site

2)Gerrit配置文件如下：（默认路径：/var/gerrit-site/etc/gerrit.conf）

[gerrit]
        basePath = git
        canonicalWebUrl = http://192.168.1.78:8081/
[database]
        type = MYSQL
        hostname = localhost
        database = reviewdb
        username = gerrit
[auth]
        type = HTTP
[sendemail]
        smtpServer = localhost
[container]
        user = root
        javaHome = /usr/lib/jvm/java-1.7.0-openjdk-1.7.0.65.x86_64/jre
[sshd]
        listenAddress = *:29418
[httpd]
        listenUrl = proxy-http://192.168.1.78:8081/
[cache]
        directory = cache

3 ) 添加用户，可以添加多个，这个用户是作为web页面的登陆用户使用的

# touch /var/gerrit-site/passwd

# htpasswd /var/gerrit-site/passwd  [new-user-name]

4) 启动、关闭、重启gerrit

# /var/gerrit-site/bin/gerrit.sh start

# /var/gerrit-site/bin/gerrit.sh stop

# /var/gerrit-site/bin/gerrit.sh restart

配置Apache

1)       配置反向代理

/etc/httpd/conf/httpd.conf
…
<VirtualHost *:80>
  ServerName localhost
  ProxyRequests Off
  ProxyVia Off
  ProxyPreserveHost On

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

  <Location /login/>
      AuthType Basic
      AuthName "Gerrit Code Review"
      AuthBasicProvider file
      AuthUserFile /var/gerrit-site/password
      Require valid-user
  </Location>

  ProxyPass / http://192.168.1.78:8081/
</VirtualHost>

2）关闭selinux，需重启

# vi /etc/selinux/config
…
SELINUX=disable
…

或者，本次有效

# setenforce 0

3) 设置权限

# chown –R apache:apache /var/gerrit-site 

4) 关闭防火墙，让局域网用户访问

# service iptables stop

5) 重启httpd服务

# service httpd restart

Gerrit的使用

创建项目

创建branch

配置项目权限

项目评审过程中，需要几个条件，代码才能最终提交到分支

l  Review  >=+2

l  Verify   >=+1

所以如果配置为每人评审最多只能+1时，则必须最少两人才能完成评审过程，当然也可以让一个用户组可以一次性review +2

配置项目权限时需要根据需要进行配置，选好拥有权限的用户组

客户端获取代码

Git clone http://[ip]:[port]/[project-name].git

如git clone http://192.168.1.78/hello.git

添加或更改文件 提交审核

此处提交代码的位置有点奇怪：HEAD:refs/for/master，其实是gerrit规定的方式，最后的master是分支名称

提交代码的快捷方式：

[remote "review"]

pushurl = http://192.168.1.78/hello.git

push = HEAD:refs/for/master

这样以后就直接：

# git push review

其中用户密码在webui页面右上角的“setting”à”HTTP Password”

评审

进入评审界面

此时可以看到页面有“Review”按钮，点击即可评审代码

评审或确认

此时可以看到用户一次评审只能+1 这是在项目的access中设置的，此项目评审结果必须>=2才可以提交，所以必须由两个用户分别评审

确认合并

待满足gerrit对项目的要求（review >=2 verify >=1）后，页面中会出现“submit patch set 1”的按钮，点击将分支合并到主干中

用户会发现，提交完毕后，“revert change”按钮出现，也就是可以revert刚才的提交动作

重新获取代码

此时在其他地方重新获取项目的分支代码，即可看到代码更新过了

git pull origin master