[原创]CI持续集成系统环境---部署gerrit环境完整记录

 

开发同事提议在线上部署一套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.warhtml

--------------------------------------------gerrit历史版本下载地址-----------------------------------------------java

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

 

---------------------------------------------------------------------------------------------------------------nginx

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/gerritgit

接着在gerrit帐号下进行安装
除了选用mysql数据库，Verified，http认证代理，其余的都是默认！ web

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

*** Gerrit Code Review 2.11.3
*** shell

*** Git Repositories
*** 数据库

Location of Git repositories [git]: vim

*** 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同步插件）的方法请见于：[原创]CI持续集成系统环境--Gitlab+Gerrit+Jenkins完整对接（文章结尾有介绍）

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

第一次手动启动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;            //AuthUserFile路径

          proxy_pass       http://103.10.86.30:8080;          //注意后面不能加"/"，不然会出现“Code Review - Error The page you requested was not found....permission to view this page”的报错

          proxy_set_header        X-Forwarded-For $remote_addr;

          proxy_set_header        Host $host;

    }

}

可是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公钥设置-------------------------------------------