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