环境：

gerrit server :176.23.47.118

SRE实战 互联网时代守护先锋，助力企业售后服务体系运筹帷幄！一键直达领取阿里云限量特价优惠。

管理员机器用户名：  su admin

gerrit 的管理员账号：admin

gerrit 工作流程

 gerrit工作流程的图：

Gerrit 配置-用户配置 随笔 第1张

使用过git的同学，都知道，当我们git add --> git commit --> git push 之后，你的代码会被直接提交到repo，也就是代码仓库中，就是图中橘红色箭头指示的那样。

那么gerrit就是上图中的那只鸟，普通成员的代码是被先push到gerrit服务器上，然后由代码审核人员，就是左上角的integrator在web页面进行代码的审核(review)，可以单人审核，也可以邀请其他成员一同审核，当代码审核通过(approve)之后，这次代码才会被提交(submit)到代码仓库(repo)中去。

无论有新的代码提交待审核，代码审核通过或被拒绝，代码提交者(Contributor)和所有的相关代码审核人员(Integrator)都会收到邮件提醒。
gerrit还有自动测试的功能，和主线有冲突或者测试不通过的代码，是会被直接拒绝掉的，这个功能似乎就是右下角那个老头(Jenkins)的任务。

整个流程就是这样。 在使用过程中，有两点需要特别注意下：

  • 当进行commit时，必须要生成一个Change-Id，否则，push到gerrit服务器时，会收到一个错误提醒。

  • 提交者不能直接把代码推到远程的master主线(或者其他远程分支)上去。这样就相当于越过了gerrit了。 gerrit必须依赖于一个refs/for/*的分支。

    假如我们远程只有一个master主线，那么只有当你的代码被提交到refs/for/master分支时，gerrit才会知道，我收到了一个需要审核的代码推送，需要通知审核员来审核代码了。
    当审核通过之后，gerrit会自动将这条分支合并到master主线上，然后邮件通知相关成员，master分支有更新，需要的成员再去pull就好了。而且这条refs/for/master分支，是透明的，也就是说普通成员其实是不需要知道这条线的，如果你正确配置了sourceTree，你也应该是看不到这条线的。

这两点很重要！！这两点很重要！！这两点很重要！！

为管理员admin配置SSH Public Keys:

第一个Gerrit 账户自动成为权限最高的管理员，因为Gerrit 安装完毕后第一件事就是立即注册或者登录，以便初始化管理员账号

Gerrit 配置-用户配置 随笔 第2张

这里需要把你的公钥钥匙拷贝出来，然后粘贴在对话中

生成公私钥对

 

首先切换到 admin用户下 ，在命令行中输入: 

[root@localhost home]# su admin
[admin@localhost home]$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/home/admin/.ssh/id_rsa):
Created directory '/home/admin/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/admin/.ssh/id_rsa.
Your public key has been saved in /home/admin/.ssh/id_rsa.pub.

找到公钥钥匙：

　　 默认公私钥的是放置在~/.ssh目录下的，默认的名称是id_rsa和id_rsa.pub。其中.pub文件就是公钥，私钥你自己需要保存好。我们要做的，就是把公钥的内容拷贝出来，然后粘贴到页面上去。注意拷贝时，要从RSA开始拷贝，如果格式不对，页面上会有提示。拷贝完成之后如下图所示：

Gerrit 配置-用户配置 随笔 第3张

测试SSH key是否提交成功，在client 服务器上执行以下命令：

#ssh -p 29418 admin@ip地址 

ps:一定要切换到你生成 公钥私钥的用户下 gerrit， 29418为gerrit上SSH服务器监听的端口，admin为登录的gerrit账号（admin 账号为我的管理员账号），并且该账号已经登录了gerrit服务器，而且公钥已经上传。

176.23.47.118为gerrit服务器的IP

[root@localhost .ssh]# su gerrit
[gerrit@localhost .ssh]$ ssh -p 29418 admin@176.23.47.118

  ****    Welcome to Gerrit Code Review    ****

  Hi admin, you have successfully connected over SSH.

  Unfortunately, interactive shells are disabled.
  To clone a hosted Git repository, use:

  git clone ssh://admin@localhost:29418/REPOSITORY_NAME.git

在gerrit服务器上创建普通用户:

Linux下的用户名须和管理员给的Gerrit账号名相同，如果没有，请添加新用户：

 Gerrit服务器使用的是HTTP认证类型，并用nginx做反向代理，创建用户使用以下命令：

[root@localhost .ssh]# htpasswd -m /home/gerrit/gerrit.password  tana
New password: 
Re-type new password: 
Updating password for user tana

创建普通用户 tana ，在gerrit网页登录进去，按照配置admin的路径 给tana用户配置ssh keys。

[tana@localhost ~]$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/home/tana/.ssh/id_rsa): 
Created directory '/home/tana/.ssh'.
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /home/tana/.ssh/id_rsa.
Your public key has been saved in /home/tana/.ssh/id_rsa.pub.

配置成功后下图所示：

Gerrit 配置-用户配置 随笔 第4张

管理员访问SSH的管理接口

 在gerrit个人配置界面中设置了公钥之后，就可以连接Gerrit的ssh服务器执行命令。注意远程gerrit服务器的端口不要被防火墙拦截，gerrit的ssh服务器使用的特殊的端口，默认是29418，任何用户都可以通过 ssh连接执行 ls-projects 命令查看项目列表

[tana@localhost root]$ ssh -p 29418 176.23.47.118 gerrit ls-projects
All-Projects
All-Users
projec1
test3

通过ssh 创建新项目：

管理员admin 可以使用命令行创建新项目 test3：

[admin@localhost root]$ ssh -p 29418 176.23.47.118 gerrit create-project test3

创建group并创建一个project

Gerrit 配置-用户配置 随笔 第5张

图片是gerrit默认的分组，之后我们还可以建立新的分组，加入新的成员

 注意，只有管理员组的用户才能创建group和Project

创建一个group

 登录Gerrit管理员账号admin，创建一个新的组为test1。并将tana账号加入该组

Gerrit 配置-用户配置 随笔 第6张

 

 Gerrit 配置-用户配置 随笔 第7张

Gerrit 配置-用户配置 随笔 第8张

 

Gerrit 配置-用户配置 随笔 第9张

创建一个project

 创建一个project1 ：BROWSE->Repositores->CREATE NEW

Gerrit 配置-用户配置 随笔 第10张

BROWSE->Repositores->Access->ADD REFERENCE->ADD

Gerrit 配置-用户配置 随笔 第11张

Gerrit 配置-用户配置 随笔 第12张

tana用户clone工程

 clone工程到本地

切换到tana用户上，下拉刚刚创建的 projec1工程：

执行命令：#git clone ssh://tana@176.23.47.118:29418/projec1.git

[tana@localhost ~]$ git clone ssh://tana@176.23.47.118:29418/projec1.git
Initialized empty Git repository in /home/tana/projec1/.git/
remote: Total 2 (delta 0), reused 2 (delta 0)
Receiving objects: 100% (2/2), done.
[tana@localhost ~]$ ls 
projec1

进入到/home/tana/中，我们发现多了一个 projec1的文件夹。这个文件夹就是我们下拉下来的projec1 工程了

下面新建一个 test.md文件 ，尝试着提交：

提交

 首先我们通过下面两个命令首先commit到本地仓库：

[tana@localhost ~]$ cd /home/tana/projec1/
[tana@localhost projec1]$ vim test.md
just for test
"test.md" [New] 1L, 14C written                                                                      
[tana@localhost projec1]$ git add test.md 
[tana@localhost projec1]$ git commit

我们把这次提交命名为for test

Gerrit 配置-用户配置 随笔 第13张

 然后我们通过git push命令来推送，发送推送失败了，错误如下：

Gerrit 配置-用户配置 随笔 第14张

Gerrit拒绝了我们直接提交到master的推送！

这就是我们在文章开头提到的问题，我们需要push到refs/for/master那条线上！！

那怎么办呢？？
我们在命令行写入下面的命令：

git config remote.origin.push refs/heads/*:refs/for/*

Gerrit 配置-用户配置 随笔 第15张

我们设置了push命令之后，重新进行push，结果又报错了。。

这次是没有注册任何邮件

 

这个是提到的第2个问题，commit一定要有Change-Id
然后我们看到了命令行中给了我们提示，我们可以从hooks文件中拷贝commit-msg文件下来，这样commit时，会自动帮我们生成Change-Id.

 

参考文献：

扫码关注我们
微信号：SRE实战
拒绝背锅 运筹帷幄