开发同事提议在线上部署一套gerrit代码审核环境，不用多说，下面就是自己部署gerrit的操作记录。

提前安装好java环境，mysql环境，nginx环境

测试系统：centos6.5

下载下面三个包，放到/root目录下

《下载地址：http://pan.baidu.com/s/1nuP0X9R （提取密码gqj5）》

mysql-connector-java-5.1.21.jar

bcpkix-jdk15on-1.52.jar

gerrit-2.11.3.war

************************gerrit历史版本下载地址*******************************************

http://gerrit-releases.storage.googleapis.com/index.html

***********************************************************************************

（1）创建gerrit数据库，并自定义编码为utf8

mysql>create database gerritdb CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql>grant all on gerritdb.* to 'gerrituser'@'localhost' identified by 'gerritpass';

（2）

[root@115 ~]#useradd gerrit

[root@115 ~]#su - gerrit

[gerrit@115 ~]$

在root账号下操作

[root@115 ~]# cp /root/gerrit-2.11.3.war /home/gerrit

下面一步很重要，就是说提前把下面的两个软件放到相应的位置，以防在gerrit安装过程中再去执行下载操作（因为安装过程中再去下载，由于网速问题会failed！）

[root@115 ~]#mkdir -p /home/gerrit/gerrit_site/lib
[root@115 ~]#cp /root/mysql-connector-java-5.1.21.jar /home/gerrit/gerrit_site/lib/
[root@115 ~]#cp /root/bcpkix-jdk15on-1.52.jar /home/gerrit/gerrit_site/lib/
[root@115 ~]#chown -R gerrit.gerrit /home/gerrit

接着在gerrit账号下进行安装

除了选用mysql数据库，Verified，http认证代理，其他的都是默认！    

[gerrit@115 ~]$ java -jar gerrit-2.11.3.war init -d ~/gerrit_site
Using secure store: com.google.gerrit.server.securestore.DefaultSecureStore

*** Gerrit Code Review 2.11.3
***

*** Git Repositories
***

Location of Git repositories [git]:

*** SQL Database
***

Database server type [h2]: mysql

Gerrit Code Review is not shipped with MySQL Connector/J 5.1.21
** This library is required for your configuration. **
Download and install it now [Y/n]?
Renaming mysql-connector-java-5.1.10.jar to .mysql-connector-java-5.1.10.jar.backupDownloading http://repo2.maven.org/maven2/mysql/mysql-connector-java/5.1.21/mysql-connector-java-5.1.21.jar ... OK
Checksum mysql-connector-java-5.1.21.jar OK
Server hostname [localhost]:
Server port [(mysql default)]:
Database name [reviewdb]: gerritdb
Database username [gerrit]: gerrituser
gerrituser's password :
confirm password :

*** Index
***

Type [LUCENE/?]:

The index must be rebuilt before starting Gerrit:
java -jar gerrit.war reindex -d site_path

*** User Authentication
***

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

*** Review Labels
***

Install Verified label [y/N]? y

*** Email Delivery
***

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

*** Container Process
***

Run as [gerrit]:
Java runtime [/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.91-1.b14.el6.x86_64/jre]:
Copy gerrit-2.11.3.war to /home/gerrit/gerrit_site/bin/gerrit.war [Y/n]?
Copying gerrit-2.11.3.war to /home/gerrit/gerrit_site/bin/gerrit.war

*** SSH Daemon
***

Listen on address [*]:
Listen on port [29418]:

Gerrit Code Review is not shipped with Bouncy Castle Crypto SSL v151
If available, Gerrit can take advantage of features
in the library, but will also function without it.
Download and install it now [Y/n]?
Renaming bcpkix-jdk15on-1.52.jar to .bcpkix-jdk15on-1.52.jar.backupDownloading http://www.bouncycastle.org/download/bcpkix-jdk15on-151.jar ... !! FAIL !!

error: http://www.bouncycastle.org/download/bcpkix-jdk15on-151.jar: 302 Found
Please download:

http://www.bouncycastle.org/download/bcpkix-jdk15on-151.jar

and save as:

/home/gerrit/gerrit_site/lib/bcpkix-jdk15on-151.jar

Press enter to continue
Continue without this library [Y/n]?
Generating SSH host key ... rsa(simple)... done

*** HTTP Daemon
***

Behind reverse proxy [y/N]?
Use SSL (https://) [y/N]?
Listen on address [*]:
Listen on port [8080]:
Canonical URL [http://Zabbix-server:8080/]:

*** Plugins
***

Installing plugins.
Install plugin download-commands version v2.11.3 [y/N]?
Install plugin reviewnotes version v2.11.3 [y/N]?
Install plugin singleusergroup version v2.11.3 [y/N]?
Install plugin replication version v2.11.3 [y/N]?
Install plugin commit-message-length-validator version v2.11.3 [y/N]?
Initializing plugins.
No plugins found with init steps.    

Initialized /home/gerrit/gerrit_site

注意：

一件安装后，默认没有安装上任何插件的，如果用到插件，需要事后手动安装。

手动安装插件（比如replication同步插件）的方法请见于：

http://www.cnblogs.com/kevingrace/p/5651447.html    （文章结尾有介绍）

************************************************************************* 

第一次手动启动gerrit服务，可能会有下面连个报错

（1）

[gerrit@115 ~]$/home/gerrit/gerrit_site/bin/gerrit.sh start

** ERROR: GERRIT_SITE not set

解决办法：

在/home/gerrit/gerrit_site/bin/gerrit.sh启动文件里添加下面一行，即指定gerrit2的路径

GERRIT_SITE=/home/gerrit/gerrit_site

（2）

[gerrit@115 ~]$ /home/gerrit/gerrit_site/bin/gerrit.sh start
Starting Gerrit Code Review: FAILED

查看日志，报错如下：
[gerrit@115 ~]$ tail -f /home/gerrit/gerrit_site/logs/error_log
[2016-07-14 10:52:07,317] INFO com.google.gerrit.server.cache.h2.H2CacheFactory : Enabling disk cache /home/gerrit/gerrit_site/cache
[2016-07-14 10:52:08,110] INFO com.google.gerrit.server.config.ScheduleConfig : gc schedule parameter "gc.interval" is not configured
[2016-07-14 10:52:08,859] INFO org.eclipse.jetty.util.log : Logging initialized @4743ms
[2016-07-14 10:52:09,278] INFO com.google.gerrit.server.git.LocalDiskRepositoryManager : Defaulting core.streamFileThreshold to 2047m
[2016-07-14 10:52:09,320] INFO com.google.gerrit.server.plugins.PluginLoader : Loading plugins from /home/gerrit/gerrit_site/plugins
[2016-07-14 10:52:09,322] ERROR com.google.gerrit.pgm.Daemon : Unable to start daemon
com.google.inject.ProvisionException: Unable to provision, see the following errors:

1) No index versions ready; run Reindex

1 error
at com.google.gerrit.lucene.LuceneVersionManager.start(LuceneVersionManager.java:119)
at com.google.gerrit.lifecycle.LifecycleManager.start(LifecycleManager.java:74)
at com.google.gerrit.pgm.Daemon.start(Daemon.java:293)
at com.google.gerrit.pgm.Daemon.run(Daemon.java:205)
at com.google.gerrit.pgm.util.AbstractProgram.main(AbstractProgram.java:64)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at com.google.gerrit.launcher.GerritLauncher.invokeProgram(GerritLauncher.java:166)
at com.google.gerrit.launcher.GerritLauncher.mainImpl(GerritLauncher.java:93)
at com.google.gerrit.launcher.GerritLauncher.main(GerritLauncher.java:50)
at Main.main(Main.java:25)

解决办法：运行reindex
[gerrit@115 ~]$ java -jar gerrit-2.11.3.war reindex -d /home/gerrit/gerrit_site
[2016-07-14 10:03:43,957] [main] WARN com.google.gerrit.pgm.util.ThreadLimiter : Limiting program to 8 threads due to database.poolLimit
[2016-07-14 10:03:44,031] [main] INFO com.google.gerrit.server.git.LocalDiskRepositoryManager : Defaulting core.streamFileThreshold to 2047m
[2016-07-14 10:03:44,492] [main] INFO com.google.gerrit.server.cache.h2.H2CacheFactory : Enabling disk cache /home/gerrit/gerrit_site/cache
Reindexing changes: done
Reindexed 0 changes in 0.0s (0.0/s)

再次启动gerrit就成功了
[gerrit@115 ~]$ /home/gerrit/gerrit_site/bin/gerrit.sh start
Starting Gerrit Code Review: OK

**************************************************************************

修改/home/gerrit/gerrit_site/etc/gerrit.config配置文件

注意下面两个配置项，修改后如下：

[gerrit]
basePath = git
canonicalWebUrl = http://103.10.86.30/                  #nginx的代理端口 

.........

[httpd]
listenUrl = http://*:8080/

下面是nginx的认证代理配置记录

[root@115 vhosts]# pwd

/usr/local/nginx/conf/vhosts

[root@115 vhosts]# cat gerrit.conf

server {

listen 80;

server_name localhost;

#charset koi8-r;

#access_log  /var/log/nginx/log/host.access.log  main;

location / {

auth_basic              "Gerrit Code Review";

auth_basic_user_file    /home/gerrit/gerrit_site/etc/passwords;

proxy_pass              http://103.10.86.30:8080/;

proxy_set_header        X-Forwarded-For $remote_addr;

proxy_set_header        Host $host;

}

}

AuthUserFile路径为/home/gerrit/gerrit_site/etc/passwords

但是nginx进程用户（这里是www）无权访问此路径，需要对/home/gerrit进行赋权： 
[gerrit@115 ~]# setfacl -m g:www:rx /home/gerrit
这一步很重要！否则，访问gerrit的时候会报500的错！

[或者 setfacl -R -m u:www:rx /home/gerrit  上面是针对所属组进行授权，这里可以针对用户授权] 

创建认证权限（也就是登陆的时候输入的权限）

注意：第一次加-c参数是为了创建密码文件，默认第一个用户是系统管理员

[root@115 vhosts]#htpasswd -c /home/gerrit/gerrit_site/etc/passwords  gerrit

New password:

Re-type new password:

Adding password for user gerrit

[root@115 vhosts]#htpasswd /home/gerrit/gerrit_site/etc/passwords wangshibo

New password:

Re-type new password:

Adding password for user wangshibo

[root@115 vhosts]#htpasswd /home/gerrit/gerrit_site/etc/passwords jenkins

New password:

Re-type new password:

Adding password for user jenkins

查看下认证账号文件信息

[root@115 vhosts]# cat /home/gerrit/gerrit_site/etc/passwords

重启nginx服务

[root@115 vhosts]# /usr/local/nginx/sbin/nginx -s reload

访问http://ip，输入上面创建的用户信息即可登陆gerrit

*************** *************** *************** *************** ***************

激活之后，在设置栏里就有邮箱可选择了

**************************************************************************************

注意：

用htpasswd创建第一个用户时默认是系统管理员，ID为1000000，默认只有这个系统管理员才有Create权限（创建group和Project），

其他的都只有“List”查看权限

用htpasswd创建的用户时，并没有往gerrit中添加账号，只有当该用户通过web登陆gerrit服务器时，该账号才会被添加进gerrit数据库中。

退出admin账号重新登陆（HTTP认证模式不支持Sign Out，需要先Sign Out退出账号，关闭浏览器后再登陆才能出现http验证密码的对话框

****************************git中文编码问题**********************************************

为妥善解决中文编码的问题，对所有git repository做如下约定：
　　a、所有文本文件都必须存储成utf8编码
　　b、对git做如下设置：
　　　　git config --global core.quotepath false
　　　　git config --global i18n.logoutputencoding utf8
　　　　git config --global i18n.commitencoding utf8
安装gerrit的时候对于数据库（选择myqsl方式的话）的编码设定为utf8

**********************gerrit对接gitweb**********************************************

上面搭建好的gerrit，登陆进去在Projects项目里的右边没有gitweb的超链接

1.需要先搭建gitweb，然后进行相关配置

[root@115 ~]# yum install -y gitweb     【或者直接yum install -y git*】

gitweb安装后的目录路径是/var/www/git

********************** ********************** ******************** 

gitweb还是蛮实用的。

可以通过打开gerrit上某个工程的gitweb，查看到这个工程代码近期的所有动向！

【默认情况下：只有gerrit的管理员权限才能查看gitweb】

【普通用户要想访问gitweb，需要后续添加访问权限，具体参照http://www.cnblogs.com/kevingrace/p/5651447.html文章底部的介绍】

如下：

********************** ********************** ******************** 

**************************ssh公钥设置********************************************