gerrit+ nginx 代码review 服务器的搭建

搭建 代码服务器使用的环境

ubuntu 14.04 64bit

 

1. 创建 gerrit 的账户

创建一个 gerrit 账户:

 $ sudo useradd gerrit -m -s /bin/bash
$ sudo passwd gerrit
$ su gerrit

 无法 su gerrit  时

  sudo su 
  vim /etc/sudoers 
  root    ALL=(ALL:ALL) ALL
  gerrit  ALL=(ALL:ALL) ALL

2. 安装java环境

		第一步:打开终端,添加ppa源

		sudo add-apt-repository ppa:openjdk-r/ppa

		第二步:更新源

		sudo apt-get update

		第三步:安装openjdk 8

		sudo apt-get install openjdk-8-jdk

		有点慢,视网络环境而定。

		第四步:配置openjdk 8为默认java环境

		sudo update-alternatives --config java

		sudo update-alternatives --config javac

		最后,验证一下是否成功

		java -version

		返回:

		openjdk version "1.8.0_91"
		OpenJDK Runtime Environment (build 1.8.0_91-8u91-b14-0ubuntu4~14.04-b14)
		OpenJDK 64-Bit Server VM (build 25.91-b14, mixed mode)

3. 安装 nginx 

Gerrit有两种工作方式,我们要采用 http 的工作方式,也就是代码审核人员,可以直接通过Web页面对提交的代码进行评审以及后续的操作。

然后Gerrit要求不能直接请求其端口,必须要使用反向代理才能正确登录。而我们知道Nginx的成功正在于其高效、轻量级以及 反向代理 ,虽然Apache也有反向代理的功能,但是如果你在安装Apache时没有开启,后续的开启过程要相对复杂一点,而Nginx就简单的多了。

3.1.安装

sudo apt-get update
sudo apt-get install nginx


3.2.卸载

sudo apt-get remove nginx nginx-common # 卸载删除除了配置文件以外的所有文件。
    sudo apt-get purge nginx nginx-common # 卸载所有东东,包括删除配置文件。
    sudo apt-get autoremove # 在上面命令结束后执行,主要是卸载删除Nginx的不再被使用的依赖包。
    sudo apt-get remove nginx-full nginx-common #卸载删除两个主要的包。
  sudo service nginx restart  #重启nginx
上面的命令基本上都能解决你在Ubuntu下安装卸载Nginx的问题。


上面的命令基本上都能解决你在Ubuntu下安装卸载Nginx的问题。


3.3 启动服务

 

ps aux|grep nginx
######启动Nginx服务
[root@typecodes ~]# service nginx start
######停止Nginx服务
[root@typecodes ~]# service nginx stop
######重启Nginx服务
[root@typecodes ~]# service nginx restart
######Nginx服务的状态
[root@typecodes ~]# service nginx status
######在Nginx服务启动的状态下,重新加载nginx.conf这个配置文件
[root@typecodes ~]# service nginx reload

fnngj@ubuntu:~$ /etc/init.d/nginx start  #启动
fnngj@ubuntu:~$ /etc/init.d/nginx stop  #关闭
fnngj@ubuntu:~$ /etc/init.d/nginx restart  #重启


3.4.修改默认端口号
改Nginx默认端口号,打开/etc/nginx/nginx.conf 文件,修改端口号。

 

server {
    listen       8088;    # 修改端口号
    server_name  localhost;


    #charset koi8-r; 


    #access_log  logs/host.access.log  main;


    location / {
        root   html;
        index  index.html index.htm;
    }

大概在文件36行的位置,将默认的80端口号改成其它端口号,如 8088。因为默认的80端口号很容易被其它应用程序占用。
   然后,通过上面命令重启nginx。访问:http://127.0.0.1:8088/
 
  有些版本的目录可能不是同一个格式 。 而是引入了子目录。可以修改子目录来实现。 

  比如存在sites-enabled 这个目录,这里就是一些配置文件。

 

 nginx -c/etc/nginx/nginx.conf     -c 表示的是使用一个配置文件,更新了配置配置文件后,也尽量执行一下
  nginx -s reload  重新启用配置文件

4.  安装gerrit 

以下内容大部分来自是: https://www.tuicool.com/articles/iAFBvu7 

 

https://www.gerritcodereview.com 

建好用户以后,我们可以把之前下载好的gerrit安装包(gerrit-2.13.4.war)拷贝到 /home/gerrit/目录下,一会方便gerrit用户来安装。

安装gerrit

在gerrit用户的目录(/home/gerrit/)下面,执行下面的命令:

$ java -jar gerrit-2.13.4.war init -d ~/gerrit_site
-d ~/gerrit_site

这个命令的意思是执行安装gerrit,会在当前目录下新建一个文件夹 gerrit_site 用来作为gerrit的根目录,在这个目录中,会安装git仓库,以及gerrit的web页面,还有gerrit的bin,etc等文件夹。

然后就开始安装过程了,安装的过程会询问很多问题,有一些判断性的问题会用 [y/N] 这样的形式,大写的字母表示默认,我们直接敲回车就表示采用默认的安装选项。

注意:

  • 我们安装的时候,可以只在 Authentication method 时输入 http ,其他全部回车用默认值,因为其他配置我们待会可以通过 etc/gerrit.config 文件进行修改
  • 期间可能会下载两个文件,这两个文件虽然都很小(不到3M),但是可能是因为GFW的原因,下载速度很慢。你可以到 /lib 文件夹下面查看他们是不是已经下载完了,或者你手动把那两个文件下载完之后,scp到 /lib 下面。 
    如果你发现已经下完了,但是安装过程卡主了,没有关系,直接 ctrl+c 然后重新安装就可以了。

下面我就把整个安装过程全部贴出来,加上一些注释,好让大家看清楚都安装了什么:

*** Gerrit Code Review 2.13.4  
***

## git 代码仓库的位置, 默认会在之前敲的init -d 目录下新建一个git文件夹
## 我们回车表示默认地址
*** Git Repositories  
***  

Location of Git repositories   [git]:   

## 数据库类型,我们直接回车表示默认的h2
*** SQL Database  
***  

Database server type           [h2]:   

## 用户认证方式,注意!!!!!这里一定要手动输入 http, 其他的就直接回车
*** User Authentication  
***  

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

## 发送email的配置,这里我们全部回车使用默认,之后通过配置文件进行修改  
*** 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-7-openjdk-amd64/jre]:  
Copy gerrit-2.13.4.war to /home/gerrit/review/bin/gerrit.war [Y/n]?  
Copying gerrit-2.13.4.war to /home/gerrit/review/bin/gerrit.war  

*** SSH Daemon  
***  

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

## 这里下载可能会失败,按照我之前说过的方法重新试一遍应该就ok了  
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 ...  


## http的反向代理,我们这里先不要设置,一路回车,尽快完成安装
*** HTTP Daemon  
***  
Behind reverse proxy           [y/N]?   
Proxy uses SSL (https://)      [y/N]?  
Subdirectory on proxy server   [/]:  
Listen on address              [*]:  
Listen on port                 [8080]:

// 插件,默认都是不安装的
*** Plugins  
***  

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

Initialized /home/gerrit_site
...

其实安装过程真的很简单,只是在 Authentication method 方式时输入 http 其他的一路回车下去就好了。

启动gerrit

安装完成之后,gerrit会自动启动,而且会开始监听两个端口:

  • 29418: 默认的ssh端口;
  • 8080: gerrit默认的web页面端口。

我们可以通过下面命令查看:

$ netstat -ltpn | grep -i gerrit

tcp        0      0 :::29418               :::*              LISTEN      49513/GerritCodeRev
tcp        0      0 :::8080                :::*              LISTEN      49513/GerritCodeRev

Nginx

接下来就该Nginx上场了。

在没有配置nginx反向之前,我们直接访问 192.168.1.100:8080/login (我们之前假设gerrit服务器的ip地址是192.168.1.100),会得到一个错误页面,这个页面对于初次使用http方式的gerrit用户可能会让你感到非常。。。绝望,笔者至少看到这个页面不下10多次。。。

就是这样图片:

下面我们就来看一下nginx需要怎样配置吧。

nginx默认配置

我们首先看一看nginx的默认配置。

注意,你的nginx应该是用root账户安装的,否则可能出现权限问题。我们需要从之前的gerrit用户退出来。

在root用户下面,输入下面的命令:

$ cd /etc/nginx/conf.d
$ ls -l

默认的nginx只有一个default.conf文件,是nginx的默认配置文件,我们这里需要新建一个专门用来处理gerrit请求的配置文件,先来看一下我的目录吧:

我这里新建了一个 gerrit.conf 文件,用来处理gerrit的反向代理。待会我们来看里面需要配置些什么,我们先来研究下nginx默认的配置文件, default.conf 吧。

上面就是默认的配置,看到这里我把端口默认的监听端口设置成了82, 因为80分配给了apache;

然后日志文件的路径在 /var/log/nginx/ 目录下,如果后面登录认证的失败的时候,我们可以在这个目录下面查找日志文件,分析失败的原因。

nginx路径在 /usr/share/nginx/ 路径下,如果我们进到该目录下,查看其下面的index.html文件,就会发现他就是我们在 192.168.1.100:82 页面中看到的关于nginx的介绍的页面。

之后还有一些注释掉的关于php的配置部分,这里不做多余的介绍。

gerrit.conf配置

重点来看下我们的 gerrit.conf 文件如何设置。

我们用 vim gerrit.conf 创建这个文件,然后输入下面的内容:

server {
     listen *:81;
     server_name gerrit.microwu.com;
     allow   all;
     deny    all;

     auth_basic "Welcomme to Gerrit Code Review Site!";
     auth_basic_user_file /home/gerrit/gerrit.password;

     location / {
        proxy_pass  http://127.0.0.1:8080;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Host $host;
     }
   }

最终是这样的:

我们来详细解释几个重点:

  • 我们监听 81 端口,原因和前面一样,80端口被apache占用了,当然你还可以设置成其他没有被占用的端口
  • auth_basic 是用于登录时弹出验证登录对话框,我盗一张图来说明一下

    图片中 服务器提示: 后面的文字,就是我们在配置中当前选项的内容

  • auth_basic_user_file 是我们输入用户名和密码之后要去验证是否匹配的文件,看到路径是放在我们的gerrit用户目录下面;这个详细的内容我们一会再来说。

  • location 部分指的的是当用户访问到 192.168.1.100:81 时,要指向的内容,这里面的proxy_pass 字段表示要做的反向代理,指向的是8080,还记得8080端口是谁在用么?对的,就是我们之前新建好的gerrit的web监听端口,也就是说,当用户访问81端口时,nginx直接把这个请求代理到8080端口上去了,这个就是所谓的 反向代理 。

重启nginx

配置好了之后,我们需要重启nginx

$ service nginx restart

然后我们去访问 http://192.168.1.100:81 页面,就能看到和上图一样的登录认证界面了。

登录认证文件

那登录认证有了,我们怎么登录呢??就需要前面的 auth_basic_user_file 文件了。

这里我们需要用apach的 htpasswd 工具来新建这个文件,这也是为什么我们虽然不用到apache的反向代理,仍然需要apache的原因。

我们通过下面的命令来在 /home/gerrit/ 路径下创建认证文件

$ sudo apt-get install apache2-utils
$ htpasswd -c /home/gerrit/gerrit.password admin

添加新用户
 htpasswd -m /home/gerrit/gerrit.password master

这个命令的详细解释:

  • -c表示create,也就是新建的意思
  • 接下来跟上文件要创建的目录以及文件名,我们直接用绝对路径,表示将在 /home/gerrit 目录下新建一个 gerrit.password 文件
  • 最后的admin表示要写入的用户名

接下来你需要在命令行中连续输入两次密码,我们就为admin用户设置好了密码,可以通过vim来查看下这个密码文件,会发现里面是经过加密的。

如果我们想新建别的用户,或者修改某个用户的密码,只需要把 -c 改成 -m 就好了,如果还是用 -c 并且路径不变的话,就会覆盖掉原来的文件。

例如:我们想要新增一个用户,master,允许其通过页面登录,只需要执行下面的命令就好了

$ htpasswd -m /home/gerrit/gerrit.password master

同样的输入两遍密码,就设置好了master用户的登录密码了。

注意 :

如果你是在root用户下输入上面的命令 创建了 gerrit.password 文件到 /home/gerrit/ 目录中,你会发现在登录的时候永远登录不成功,永远会得到服务器500的错误页面。原因是 /homt/gerrit/ 文件夹的权限问题。

我们知道, /home/gerrit/ 是我们之前新建的gerrit用户的,那么这个文件夹的权限是700,也就是只允许gerrit用户访问,其他组的用户是访问不了的,虽然这个文件的权限拥有root用户的所有权限,但是因为它放在700权限的文件夹下面,所以同样其他用户是访问不到的。

这个问题之前纠缠了我好久,通过nginx的日志可以清楚的看到访问拒绝的错误。

所以,我们需要通过下面的命令,来改变gerrit目录的权限

$ chmod 755 /home/gerrit

这样,当前目录权限就变成了 drwxr-xr-x ,也就是其他组的用户也拥有了读取和执行的权利。

修改gerrit配置

好了,配置好了nginx,我们接下来修改下gerrit的配置  /home/gerrit/gerrit.config,我们要做下面几个事情:

  • 配置SMTP邮件发送
  • 配置反向代理

先来看一下我最终成品图,红框里面的东西是需要我们特别注意的:

 

  1. canonicalWebUrl 就是gerrit的主页地址。开篇时,我们假设gerrit服务器的ip地址是 192.168.1.100 ,这里我们就需要设置成 http://192.168.1.100:8080
  2. auth的类型一定要是http,这是我们在安装的时候 唯一 需要手动设置的地方
  3. sendemail选项就是我们的邮件发送设置,如果你的gerrit服务器上没有搭建邮件服务器,那你可以用smtp发件代理,我这里去我们公司的邮箱注册了一个gerrit专用邮箱 gerrit@microwu.com ,我们公司使用的是阿里云的服务,所以smtp服务器地址是 smtp.mxhichina.com ,端口使用 465 ,因为使用的是 SSL 认证,然后 smtpPass 填写上之前专用邮箱的密码。

    sendemail有什么作用呢?

    • 当有新的允许登录web页面的成员需要修改自己的邮箱时,点击注册邮箱,我们这个专用邮箱就会向该成员申请的邮箱中发送一封确认邮件。
    • 位于Administrator组中的用户,设置了想要watch的项目之后,所有和该项目相关的事件,都能收到一封邮件提醒,发送来自于这个专有邮箱

      具体的细节我们在下一篇文章中再详细介绍

  4. sshd就是ssh监听的端口,这个我们在安装gerrit时采用的是默认的配置,也就是 29418 这个端口
  5. httpd表示反向监听的端口,这里注意要修改成 proxy-http://*:8080/ ,默认值是没有proxy的

重启gerrit

完成上面的配置之后,我们重启一下gerrit

gerrit的可执行文件位于 /home/gerrit/gerrit_site/bin 目录下,我们直接执行

$ /home/gerrit/gerrit_site/bin/gerrit.sh restart

这样,gerrit就会重新启动,并且加载我们刚才修改的配置。

重启完成之后,我们可以在浏览器中输入 192.168.1.100:81 看看是不是可以弹出输入用户名和密码的对话框(如果没有,请检查你的Nginx配置);然后输入正确的用户名(我们创建的密码文件用户是admin)和密码,如果你能登录到这个页面,就表示你的gerrit已经成功配置好了!

 

 

需要注意的是,gerrit配置了之后,第一个登录成功的用户,自动成为管理员,gerrit会给他分配一个id, 1000000 ,之后登录的成员会依次自增1,初始时 Full Name 和 Email Address字段都是空的。

关于Gerrit的安装和配置Nginx实现反向代理的内容都介绍完了,关于如何使用Gerrit以及Gerrit的工作原理和流程,我们在下一个章节再介绍。

补充内容

卸载Gerrit

如果你的安装过程出错了,或者觉得安装的不够好,比如文件位置什么的,你可以重新安装。

如果你的gerrit服务已经处于运行中,需要先执行下面的命令把它停掉

$ /home/gerrit/gerrit_site/bin/gerrit.sh stop
sh stop

然后直接删除 /home/gerrit/gerrit_site/ 整个文件夹就好了。

如果你的gerrit服务没有正常退出,可能会发现这个文件夹删除不掉(cache 和 db这两个文件夹一直都会存在),其实是因为还有gerrit的进程在跑,我们要做的是找出gerrit的进程,然后kill掉就好了

$ ps -ef | grep gerrit

看上图中的最后一条,就是当前gerrit的进程,49513就是其进程id

我们接着执行

$ kill -9 49513

就强制关闭了gerrit进程,然后再试着删除整个 gerrit_site 文件夹就好了。

退出gerrit网页

如果你已经成功登录了gerrit的网页,那么如果你想退出,请直接关闭整个浏览器,gerrit没有做logout的session清除,所以如果你直接点击网页右上角的logout,要么会出错,要么就会进入到之前那个提示需要反向代理的错误页面。关于登出,gerrit给出的原因是:

You are using HTTP Basic authentication. There is no way to tell abrowser to quit sending basic authentication credentials, to logout with basicauthentication is to close the Webbrowser.

 

补充:外部访问的是81端口,内容通过 反向代理,给到了8080端口,而8080端口正好是 gerrit 监听的端口(这个可以在配置的时候修改)。 nginx 的server_name 也可以修改成自己的ip 地址,这样就可以在局域网内进行访问了

 

5.其他 参考


apache nginx 都可以配置 反向代理

 

根据域名自动转发到相应服务器的特定端口

http://www.ttlsa.com/nginx/use-nginx-proxy/

 

Nginx + Tomcat 

https://blog.csdn.net/wang379275614/article/details/47778201

 

ubuntu 下 nginx 的安装和卸载

https://www.cnblogs.com/zhaoyingjie/p/6840616.html

 

https://www.jianshu.com/p/b77fd16894b6

 

Starting Gerrit Code Review: FAILED

https://blog.csdn.net/miss_yuan/article/details/79142897

 

参考:
nginx的gerrit.config 

server {
     listen *:81;
     server_name 192.168.0.3;
     allow   all;
     deny    all;

     auth_basic "Welcomme to Gerrit Code Review Site!";
     auth_basic_user_file /home/gerrit/gerrit.password;

     location / {
        proxy_pass  http://127.0.0.1:8080;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Host $host;
     }
   }



gerriy.conf 的

gerrit]
        basePath = git
        serverId = 8f69b1bd-354b-41e9-8795-cf06d42775d0
        canonicalWebUrl = http://192.168.0.3:8080/
[database]
        type = h2
        database = /home/gerrit/gerrit_site/db/ReviewDB
[index]
        type = LUCENE
[auth]
        type = HTTP
[receive]
        enableSignedPush = false
[sendemail]
xx
[container]
        heapLimit = 6000m
        user = gerrit
        javaHome = /usr/lib/jvm/java-8-openjdk-amd64/jre
[sshd]
        listenAddress = *:29418
[httpd]
        listenUrl = proxy-http://*:8080/
[cache]
        directory = cache


 

  • 2
    点赞
  • 6
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值