搭建gerrit服务器(apache&nginx反向代理方式)

       这段时间，想搭建一个gerrit，用于代码托管，gerrit的搭建，网上有很多种教程，但是自己按照别人的教程逐步操作，一直出现诸多问题。最头痛的就是：
Configuration Error

Check the HTTP server's authentication settings.

      后来经过他人指点，才知道自己的原因。由于对Apache的反向代理的机制，没有清楚，导致寸步难行。现将搭建方式进行记载：

一.gerrit的搭建

     由于gerrit和Apache的安装，网上教程已经很多，这里就不一一说明了。本文主要讲解如何配置Apache的反向代理.

    本次搭建环境为VMware上的Ubuntu12.04，通过Windows上，ssh去操作。 Ubuntu虚拟机的ip地址为192.168.1.6,Windows的IP地址为192.168.1.3。搭建的gerrit服务器，在Windows上通过http://192.168.1.6:9999/进行访问。

   假定gerrit已经成功安装到Ubuntu，其路径为：/home/gerrit/review-gerrit

  进入etc路径，即/home/gerrit/review-gerrit/etc,这里贴出gerrit.config文件：

[gerrit]
    basePath = /home/gerrit/prj-source
    canonicalWebUrl = http://192.168.1.6:10000
[database]
    type = h2
    database = db/ReviewDB
[auth]
    type = HTTP
[sendemail]
    smtpServer = localhost
[container]
    user = root
    javaHome = /usr/lib/jvm/java-6-openjdk-amd64/jre
[sshd]
    listenAddress = *:29418
[httpd]
    listenUrl = http://*:10000

      完成以上的步骤，比较简单，很多教程都有过描述。下面主要讲解Apache的反向代理。

      首先简单描述一下反向代理的基础：反向代理（Reverse Proxy）方式是指以代理服务器来接受internet上的连接请求，然后将请求转发给内部网络上的服务器，
并将从服务器上得到的结果返回给internet上请求连接的客户端，此时代理服务器对外就表现为一个反向代理服务器。

         例如我们想通过PC浏览器去访问http://192.168.1.6:9999，就是一个反向代理。在/home/gerrit/review-gerrit/etc/gerrit.config中，我们配置gerrit端口bind在10000，为啥外部通过访问端口9999，就可以打开gerrit的web页面？

        原因就是Apache的反向代理功能。那就开始配置Apache吧！

        a.第一步，要在Apache上新增端口9999，用户监听网络事件。修改配置文件/etc/apache2/ports.conf。    

    NameVirtualHost *:80
    Listen 80
    Listen 9999

        b.第二步，增加反向代理的配置。/etc/apache2/sites-enabled/000-default

    ServerName 192.168.1.6
    ProxyPreserveHost On
    ProxyRequests Off
    
        Order deny,allow
        Allow from all
    
    
      AuthType Basic
      AuthName "Welcomme to Gerrit Code Review Site!"
      Require valid-user
      AuthUserFile /home/gerrit/review-gerrit/htpasswd.conf
    
    ProxyPass / http://192.168.1.6:10000/
    proxyPassReverse / http://127.0.0.1:10000/

        c.完成以上配置，则成功。然后restart Apache和gerrit服务即可

     然后在pc浏览器上输入：http://192.168.1.6:9999/,则启动gerrit

     
      输入账号密码，显示如下：

   

       gerrit安装配置成功。

     如果不适用Apache进行反向代理，使用nginx则更加简单，直接修改一个文件就可以了。/etc/nginx/conf.d/gerrit.conf，没有这个文件，则直接touch gerrit.conf就可生成，然后编辑一下。

server {
     listen *:9999;
     server_name 192.168.1.6;
     allow   all;
     deny    all;
     auth_basic "Welcomme to Gerrit Code Review Site!";
     auth_basic_user_file /home/gerrit/review-gerrit/htpasswd.conf;

     location / {
        proxy_pass  http://127.0.0.1:10000;
     }
   }

    按照以上步骤，可以搭建一个gerrit服务器了。

   另外，关于gerrit服务器的后台权限&项目管控，还在逐步研究。