• gerrit上的commit msg中关联jira单号(含gerrit的安装)


      这个问题折腾了很久,前期后后大概一个月吧,终于搞定了,查了很多资料,有的不完整,有的完全就不能用,有的没说完整,所以一定要记录下来,我的心血啊。

      由于公司在用的gerrit的是正式环境中的,大家都在使用,并且这又是个没接触过的新的配置,所以,担心在正式服务器上调试影响大家工作,所以只能在其他机器上搭建一套完整的系统来调试,主要是搭建gerrit平台,网上很多都是apache和mysql之类的,搭建下来配置来配置去都有问题,这里给大家推荐一个“gerrit + apache + nginx”,参考:https://blog.csdn.net/peterxiaoq/article/details/73330314

    系统是centos的系统。

    准备工作:

      (1)首先安装jdk,这个就不多说了

      (2)安装apache:yum install httpd

      (3)安装nginx: 参考https://blog.csdn.net/zql3315/article/details/54924689   (备注:执行1,2就行了)

    说明:你可能会想,为啥安装了nginx了还要安装apache,博客了很清楚的说明了原因,此外这里主要用在执行创建gerrit用户的时候。

    接下来就开始安装gerrit了,参考博客就行,我把其中重要的部分捡了出来,

    1.创建gerrit专有用户

      adduser gerrit

      su gerrit

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

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

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

     我们安装的时候,可以只在 Authentication method 时输入 http ,以及安装插件时输入“y”,(默认插件是不安装的),其他全部回车用默认值,如下这里:

     (1)Authentication method          [OPENID/?]: http  
      (2)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]?

     因为其他配置我们待会可以通过 etc/gerrit.config 文件进行修改。

      还需要修改listenUrl =http://*:8080/,在http前面加"proxy-  "

    到此我的gerrit.config文件内容如下(重点部分如红色标记):

      [gerrit]
        basePath = git
        canonicalWebUrl = http://192.168.8.204:8080/
      [database]
        type = h2
        database = /home/gerrit/gerrit_site/db/ReviewDB
      [index]
        type = LUCENE
      [auth]
        type = HTTP
      [receive]
        enableSignedPush = false
      [sendemail]
        smtpServer = localhost
      [container]
        user = gerrit
        javaHome = /usr/java/jdk1.8.0_101/jre
      [sshd]
        listenAddress = *:29418
      [httpd]
        listenUrl = proxy-http://*:8080/
    [cache]
    directory = cache

    3.nigix配置:

     你的nginx应该是用root账户安装的,否则可能出现权限问题。我们需要从之前的gerrit用户退出来,然后执行下面两条命令:

      cd /etc/nginx/conf.d ; touch gerrit.conf

      然后 vim gerrit.conf,输入如下内容:

      server {
        listen *:81;
        server_name 192.168.8.204; (根据自己的实际情况,输入的是gerrit主机ip)
        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;
        }
      }
       然后重启nginx:

        service nginx restart

    4.登陆认证文件

    上面的gerrit.conf文件中,我们看到了:auth_basic_user_file /home/gerrit/gerrit.password,这里我们需要用apach的 htpasswd 工具来新建这个文件,这也是为什么我们虽然不用到apache的反向代理,仍然需要apache的原因。

      htpasswd -c /home/gerrit/gerrit.password admin  

      然后输入密码就可以了,这个密码会被加密(一般情况下,我更偏向于用户名和密码设置成一样的,方便记忆,比如我的用户名密码都是admin)

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

    注意 :

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

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

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

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

    chmod 755 /home/gerrit

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

    5.重启gerrit服务

      如上,我的gerrit的安装路径是/home/gerrit/gerrit_site,进入到这里目录,然后进入到里面的bin目录,我们看到一个gerrit.sh的文件,执行命令:

      sh gerrit.sh restart

    6.登陆网页

      在浏览器上输入http://192.168.8.204:81即可,然后输入刚才步骤4里的用户名密码即可。然后回引导你做基本的设置,填写fullname 和'SSH Public Keys',这两个都很简答,就不细说了,ssh public keys是为了能下载代码。创建一个新的工程test,你就可以在本地下载代码了(ssh public keys和电脑是强相关的,如果你要在主机A上下载,就要把主机A的public key放上去,如果要在主机B上下,就要把主机B的public key放上去,如果主机重装系统了,你必须重新生成public key放上去,复杂不能下载;我的生成命令:ssh-keygen -t rsa -C anl@hpplay.cn;cat ~/.ssh/id_rsa.pub (public key还有其他生成方式,根据自己的情况可以参考其他人的)

     7.commit-msg关联jira单号

      查了很多,关于这方面的资料很少,并且有的说要装插件,可是我还是不行,其实简单的改下gerrit.config的配置就可以了,如上,我的gerrit路径是/home/gerrit/gerrit_site,修改这个目录下的etc/gerrit.config,添加如下内容:

      [commentlink "jira"]

        match = ([A-Z]+-[0-9]+)
        link = http://你的jira_url/browse/$1  

    其中link中需要填写你的jira的url,比如我的是“link = http://jira.hpplay.cn:6060/browse/$1 ”

    如果第一段中包含了字母和数字,则使用如下配置:

            [commentlink "jira"]

                match = ([A-Z0-9]+-[0-9]+)

                link = http://jira.hpplay.cn:6060/browse/$1

    你可能会问,“$1”是什么,要怎么传入,他怎么识别提交的commit message的哪些是单号,至少要有个什么标志之类的,怎么触发这个配置生效呢,开始的时候,我也一直在思考这些问题,也一直想不明白,然后就先放一下(后面想通了,这个$1对应的就是math匹配到的字段,格式是“大写字母-数字”),重启了gerrit服务(sh  /home/gerrit/gerrit_site/bin/gerrit.sh restart ), 并提交了一次代码,刷新界面或者重新登陆,commit message中包含了我的jira单号,结果达到效果了,如下:

      

    看,变成蓝色的超链接了,点击就可以打开jira上这个单号的详细内容,如下:

    到此,gerrit上的commit message中关联jira单号算是打通。这样做的好处,是方便代码review的时候能方便看到具体解决了什么问题。

     如果你在参考本博客配置的过程中有什么问题,欢迎留言。

    其他备注:

    (1)yum install -y gitweb  安装gitweb 个人觉得没什么用
    (2)ssh -p 29418 gerrit@192.168.8.204 gerrit plugin ls 查看已经安装的插件

    (3)fatal: remote installation is disabled  要开启,配置如下:

      [plugins]
        allowRemoteAdmin = true

    (4)ssh -p 29418 admin@192.168.8.204 gerrit plugin ls报错Permission denied (publickey):
        参考:https://blog.csdn.net/pengjin1985/article/details/7789909

    (5)插件安装:

      参考:http://192.168.8.204:8080/Documentation/cmd-plugin-install.html
      ssh -p 29418 admin@192.158.8.204 gerrit plugin install -n download-commands -<download-commands.jar
      ssh -p 29418 admin@192.158.8.204 gerrit plugin install -n download-commands.jar -<./tools/download-commands.jar

    command 注意点备份:

    su gerrit
    java -jar gerrit-2.12.4.war init -d ~/gerrit_site
    验证类型一定要选http
    最后的gerrit插件直接会出默认是不安装的,所以如果要安装要选y才会安装
    ssh -p 29418 admin@192.168.8.204 gerrit plugin ls
    vim gerrit_site/etc/gerrit.config
    listenUrl = proxy-http://*:8080/
    [plugins]
    allowRemoteAdmin = true

    sh gerrit_site/bin/gerrit.sh start
    exit

    如果是好久没用机器了,记得先启动nginx,然后再启动gerrit:  service nginx restart;sh gerrit_site/bin/gerrit.sh start

    http://192.168.8.204:81
    admin admin
    cat ~/.ssh/id_rsa.pub
    systemctl status nginx
    systemctl start nginx #启动
    systemctl stop nginx #停止
    systemctl restart nginx #重启
    systemctl status nginx #查看运行状态
    ssh -p 29418 admin@192.168.8.204 gerrit plugin install -n download-commands.jar /home/gerrit/tools/download-commands.jar
    mysql -u root -p123456

    gerrit新用户权限开通命令:
    htpasswd -b /home/gerrit/gerrit.password username password

    gerrit搭建参考:

    https://blog.csdn.net/zql3315/article/details/54924689
    https://blog.csdn.net/peterxiaoq/article/details/73330314 

  • 相关阅读:
    级数求和
    c++版a+b问题的各种无聊做法
    2017 Multi-University Training Contest
    2017 Multi-University Training Contest
    [DP] UVA-1626 Brackets sequence
    Codeforces Round #426 (Div. 2) [A、B、C]
    一只弱菜的博客之旅
    关于数据库保存的二进制图片无法在colorbox插件中显示的解决办法
    windows+caffe+vs2013+cuda6.5配置记录
    Ubuntu14.04+cuda6.5+opencv2.4.9+MATLAB2013a+caffe配置记录(五)——安装Caffe
  • 原文地址:https://www.cnblogs.com/zndxall/p/9356517.html
Copyright © 2020-2023  润新知