Gerrit安裝配置

環境: CentOS 1611 + gerrit-2.11.4 (review.openstack.org)

1. 安裝java1.8 (>1.7)

[root@review ~]# yum install java

[root@review ~]# java -version
openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-b12)
OpenJDK 64-Bit Server VM (build 25.131-b12, mixed mode)

2. 安裝mariadb (mysql)

[root@review ~]# yum install -y mariadb*       # 安裝
[root@review ~]# systemctl start mariadb.service 　　＃啟動
[root@review ~]# systemctl enable mariadb.service    ＃開機啟動

# 首次配置mariadb
[root@review ~]# mysql_secure_installation 

NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB
      SERVERS IN PRODUCTION USE!  PLEASE READ EACH STEP CAREFULLY!

In order to log into MariaDB to secure it, we'll need the current
password for the root user.  If you've just installed MariaDB, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.

Enter current password for root (enter for none):     # 默認為空
OK, successfully used password, moving on...

Setting the root password ensures that nobody can log into the MariaDB
root user without the proper authorisation.

Set root password? [Y/n]     # 新密碼
New password: 
Re-enter new password: 
Password updated successfully!
Reloading privilege tables..
 ... Success!


By default, a MariaDB installation has an anonymous user, allowing anyone
to log into MariaDB without having to have a user account created for
them.  This is intended only for testing, and to make the installation
go a bit smoother.  You should remove them before moving into a
production environment.

Remove anonymous users? [Y/n] 
 ... Success!

Normally, root should only be allowed to connect from 'localhost'.  This
ensures that someone cannot guess at the root password from the network.

Disallow root login remotely? [Y/n] n
 ... skipping.

By default, MariaDB comes with a database named 'test' that anyone can
access.  This is also intended only for testing, and should be removed
before moving into a production environment.

Remove test database and access to it? [Y/n] 
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!

Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.

Reload privilege tables now? [Y/n] 
 ... Success!

Cleaning up...

All done!  If you've completed all of the above steps, your MariaDB
installation should now be secure.

Thanks for using MariaDB!
[root@review ~]# mysql -uroot -p
Enter password: 
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 10
Server version: 5.5.52-MariaDB MariaDB Server

Copyright (c) 2000, 2016, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [(none)]> create user 'gerrit'@'localhost' identified by 'password';
MariaDB [(none)]> create database reviewdb;
MariaDB [(none)]> grant all on reviewdb.* to 'gerrit'@'localhost';
MariaDB [(none)]> flush privileges;

3. 安裝gerrit

換mysql數據庫, 安裝verify label, 用http認證, 安裝所有插件

[root@review ~]# java -jar gerrit-2.11.4.war init -d /usr/local/gerrit_site/
Using secure store: com.google.gerrit.server.securestore.DefaultSecureStore

*** Gerrit Code Review 2.11.4
*** 

Create '/usr/local/gerrit_site' [Y/n]? 

*** 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]? 
Downloading 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)]: 3306
Database name                  [reviewdb]: 
Database username              [root]: gerrit
gerrit's password              : 
              confirm password : 

*** Index
*** 

Type                           [LUCENE/?]: 

*** User Authentication
*** 

Authentication method          [OPENID/?]: ?
       Supported options are:
         openid
         openid_sso
         http
         http_ldap
         client_ssl_cert_ldap
         ldap
         ldap_bind
         custom_extension
         development_become_any_account
         oauth
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                         [root]: 
Java runtime                   [/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/jre]: 
Copy gerrit-2.11.4.war to /usr/local/gerrit_site/bin/gerrit.war [Y/n]? 
Copying gerrit-2.11.4.war to /usr/local/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]? 
Downloading 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:

  /usr/local/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://review.infra:8080/]: http://192.168.11.9:8080

*** Plugins
*** 

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

Initialized /usr/local/gerrit_site
Executing /usr/local/gerrit_site/bin/gerrit.sh start
Starting Gerrit Code Review: OK
Waiting for server on 192.168.11.9:8080 ... OK
Opening http://192.168.11.9:8080/#/admin/projects/ ...FAILED
Open Gerrit with a JavaScript capable browser:
  http://192.168.11.9:8080/#/admin/projects/

 如果啟動出錯, $gerrit_site/logs/error_log 中提示reindex ..... 執行:

java -jar gerrit-2.11.4.jar reindex -d $gerrit_site
...

$gerrit_site/bin/gerrit.sh start

4. gerrit配置

配置文件路徑:　$gerrit_sit/etc/gerrit.config

 a. 郵箱配置

　　保證兩個文件中的smtpPass密碼(實際郵箱密碼)一致

 　　

[root@review ~]# vim /usr/local/gerrit_site/etc/gerrit.config
...
[sendemail]
        smtpServer = smtp.163.com
        smtpUser = [e-mail]
        from = GerritReviewAdmin<[e-mail]>
        smtpPass = xxxxxxxxx
...

[root@review ~]# vim /usr/local/gerrit_site/etc/secure.config
...
[sendemail]
        smtpPass = xxxxxxxxx
...

Email Config

 

打開郵箱, 打開鏈接, 郵箱才注冊成功

 

b. 公鑰私鑰配置

[root@review project]# ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
5b:e3:bc:0b:c7:19:88:7f:d2:82:09:dc:f9:cd:56:2c [e-mail]
The key's randomart image is:
+--[ RSA 2048]----+
|                 |
|                 |
|                 |
|   . . o . .     |
|    o + S E o    |
|     . = X *     |
|      o B %      |
|         B .     |
|          o.     |
+-----------------+

復制生成的公鑰~/.ssh/id_rsa.pub到gerrit上,並復制gerrit上的known_hosts內容到~/.ssh/known_hosts (也可自動連接時生成)

 

 

 

c. 修改gerrit配置 (添加標簽Verified, Workflow Label)

按上步配置好后, git clone All-Projects, 並修改里面的project.config文件

[root@review All-Projects]# vim project.config
......
[label "Verified"]
        function = MaxWithBlock
        value = -2 Fails
        value = -1 Doesn't seem to work
        value =  0 No score
        value = +1 Works for me
        value = +2 Verified
        defaultValue = 0
[label "Workflow"]
        function = MaxWithBlock
        value = -1 Work in progress
        value =  0 Ready for reviews
        value = +1 Approved
        defaultValue = 0

[root@review All-Projects]# git add .
[root@review All-Projects]# git commit -m "add workflow label"
[detached HEAD a711d36] add workflow label
 1 file changed, 11 insertions(+), 2 deletions(-)
[root@review All-Projects]# git push origin HEAD:refs/meta/config
Counting objects: 5, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 491 bytes | 0 bytes/s, done.
Total 3 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1)
remote: Processing changes: refs: 1, done    
To ssh://gerrit@192.168.11.9:29418/All-Projects
   7105330..a711d36  HEAD -> refs/meta/config

添加Verifyed和Workflow  選項 

 

d. gerrit html 主題配置

參考openstack的gerrit review: https://review.openstack.org

 簡要教程: https://review.openstack.org/Documentation/config-themes.html

 需要的靜態文件可以從這里提取, 也可自行編寫或修改

部好后效果圖: 

 

5. 部署到Apache 或 Nginx

如果不配置會出現以下錯誤

 

[root@review ~]# yum install -y httpd
Installed:
  httpd.x86_64 0:2.4.6-45.el7.centos.4                                         

Dependency Installed:
  httpd-tools.x86_64 0:2.4.6-45.el7.centos.4   mailcap.noarch 0:2.1.41-2.el7  

Complete!

 a. Apache配置:

[root@review ~]# vim /usr/local/gerrit_site/etc/gerrit.config                    
[gerrit]
        basePath = git
        canonicalWebUrl = http://192.168.11.9
[database]
        type = mysql
        hostname = localhost
        port = 3306
        database = reviewdb
        username = gerrit
[index]
        type = LUCENE
[auth]
        type = HTTP
[sendemail]
        smtpServer = localhost
[container]
        user = root
        javaHome = /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.131-3.b12.el7_3.x86_64/jre
[sshd]
        listenAddress = *:29418
[httpd]
        listenUrl = proxy-http://192.168.11.9:8080/
[cache]
        directory = cache

[root@review httpd]# vim conf.d/gerrit.conf 

<VirtualHost *:80>  
    ServerName 192.168.11.9  
    ProxyPreserveHost On
    ProxyRequests Off
    ProxyVia Off

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

    <Location />      
      AuthType Basic
      AuthName "Welcomme to Gerrit Code Review Site!"
      Require valid-user
      AuthBasicProvider file
      AuthUserFile /usr/local/gerrit_site/etc/passwords
    </Location>

    AllowEncodedSlashes On
    ProxyPass / http://192.168.11.9:8080/
    #proxyPassReverse / http://127.0.0.1:8080  

</VirtualHost>

http://192.168.11.9 輸入用htpasswd產生的用戶和密碼登陸, 第一個用戶是管理員用戶(注冊郵箱).

 b. Nginx

[root@review conf]# cat gerrit.conf

server {

listen 80;

server_name localhost;


location / {

          auth_basic              "Gerrit Code Review";

          auth_basic_user_file    /usr/local/gerrit_site/etc/passwords;

          proxy_pass       http://192.168.11.9:8080;
          proxy_set_header        X-Forwarded-For $remote_addr;

          proxy_set_header        Host $host;

    }

}

 

6. gitweb對接

安裝, 安裝后的gitweb目錄 /var/www/git

[root@review ~]# yum install -y gitweb

[root@review ~]# git config --file /usr/local/gerrit_site/etc/gerrit.config gitweb.cgi /var/www/git/gitweb.cgi 
[root@review ~]# git config --file /usr/local/gerrit_site/etc/gerrit.config --unset gitweb.url
[root@review ~]# /usr/local/gerrit_site/bin/gerrit.sh restart
Stopping Gerrit Code Review: OK
Starting Gerrit Code Review: OK
[root@review ~]#

　

 

REF1: http://www.cnblogs.com/kevingrace/p/5624122.html

REF2: http://www.cnblogs.com/kevingrace/p/5651447.html