Gerrit - 一些基本用法

1 - 主配置文件

主配置文件位于$GERRIT_SITE/etc/gerrit.config目录

[gerrit@mt101 ~]$ cat gerrit_testsite/etc/gerrit.config
[gerrit]
    basePath = git
    canonicalWebUrl = http://192.168.16.101:8083/
    serverId = 0b911b9e-195a-46b0-a5cd-b407b776b344
[container]
    javaOptions = "-Dflogger.backend_factory=com.google.common.flogger.backend.log4j.Log4jBackendFactory#getInstance"
    javaOptions = "-Dflogger.logging_context=com.google.gerrit.server.logging.LoggingContext#getInstance"
    user = root
    javaHome = /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.161-2.b14.el7.x86_64/jre
[index]
    type = lucene
[auth]
    type = HTTP
[receive]
    enableSignedPush = false
[sendemail]
    smtpServer = localhost
[sshd]
    listenAddress = *:29418
[httpd]
    listenUrl = http://192.168.16.101:8083/
[cache]
    directory = cache
[gerrit@mt101 ~]$

2 - Gerrit的用户和群组

Gerrit是基于群组来进行权限控制的,不同的群组具有不同的权限。
每个用户属于一个或者多个群组。

Gerrit系统自带群组

  • Anonymous Users:所有用户自动属于该群组,默认只有Read权限
  • Change Owner:某个提交的拥有者,具备所属变更的权限
  • Project Owners:项目拥有者,具备所属项目的权限
  • Registered Users:所有成功登录的用户自动属于该群组,具备投票权限(CodeReview +1-1)

Gerrit预先定义的群组

  • Administrators:该群组的成员可以管理所有项目和Gerrit的系统配置
  • Non-Interactive Users:该群组的成员可以通过Gerrit界面进行操作,一般用于和第三方系统集成

3 - 进程和服务控制

[gerrit@mt101 ~]$ ll gerrit_testsite/bin/gerrit.sh
-rwxr-xr-x 1 root root 16109 Dec 10 14:43 gerrit_testsite/bin/gerrit.sh
[gerrit@mt101 ~]$ 
[gerrit@mt101 ~]$ $GERRIT_SITE/bin/gerrit.sh
Usage: gerrit.sh {start|stop|restart|check|status|run|supervise|threads} [-d site]
[gerrit@mt101 ~]$

4 - 查看日志

日志所在目录:$GERRIT_SITE/logs/

[gerrit@mt101 logs]$ pwd
/home/gerrit/gerrit_testsite/logs
[gerrit@mt101 logs]$ ll
total 28
-rw-r--r-- 1 root root  3052 Dec 10 15:12 error_log
-rw-r--r-- 1 root root     0 Dec 10 14:44 gc_log
-rw-r--r-- 1 root root     5 Dec 10 14:43 gerrit.pid
-rw-r--r-- 1 root root    16 Dec 10 14:44 gerrit.run
-rw-r--r-- 1 root root 13067 Dec 10 15:12 httpd_log
-rw-r--r-- 1 root root     0 Dec 10 14:44 sshd_log
[gerrit@mt101 logs]$

5 - war包的命令

war包在命令行下用很多可用命令。

[gerrit@mt101 ~]$ ll
total 67556
-rw-r--r--  1 gerrit gerrit 69172528 Dec 10 13:04 gerrit-3.1.0.war
-rwxr-xr-x  1 root   root         91 Dec 10 14:52 gerrit.password
drwxr-xr-x 14 root   root        150 Dec 10 14:44 gerrit_testsite
[gerrit@mt101 ~]$ 
[gerrit@mt101 ~]$ 
[gerrit@mt101 ~]$ sudo java -jar gerrit-3.1.0.war
Gerrit Code Review 
usage: java -jar gerrit-3.1.0.war command [ARG ...]

The most commonly used commands are:
  init            Initialize a Gerrit installation
  reindex         Rebuild the secondary index
  daemon          Run the Gerrit network daemons
  version         Display the build version number
  passwd          Set or change password in secure.config

  ls              List files available for cat
  cat FILE        Display a file from the archive

[gerrit@mt101 ~]$ 
[gerrit@mt101 ~]$ sudo java -jar gerrit-3.1.0.war init -h
init [--batch (-b)] [--delete-caches] [--dev] [--help (-h)] [--install-all-plugins] [--install-plugin VAL] [--list-plugins] [--no-auto-start] [--no-reindex] [--secure-store-lib VAL] [--show-stack-trace] [--site-path (-d) VAL] [--skip-all-downloads] [--skip-download VAL] [--skip-plugins]

 --batch (-b)           : Batch mode; skip interactive prompting (default:
                          false)
 --delete-caches        : Delete all persistent caches without asking (default:
                          false)
 --dev                  : Setup site with default options suitable for
                          developers (default: false)
 --help (-h)            : display this help text (default: true)
 --install-all-plugins  : Install all plugins from war without asking (default:
                          false)
 --install-plugin VAL   : Install given plugin without asking
 --list-plugins         : List available plugins (default: false)
 --no-auto-start        : Don't automatically start daemon after init (default:
                          false)
 --no-reindex           : Don't automatically reindex any entities (default:
                          false)
 --secure-store-lib VAL : Path to jar providing SecureStore implementation class
 --show-stack-trace     : display stack trace on failure (default: false)
 --site-path (-d) VAL   : Local directory containing site data
 --skip-all-downloads   : Don't download libraries (default: false)
 --skip-download VAL    : Don't download given library
 --skip-plugins         : Don't install plugins (default: false)


[gerrit@mt101 ~]$

6 - Gerrit解决冲突的提交

如果不同的开发人员同时修改同一个文件并提交,那么这些提交都不会进入代码库。
Gerrit会在页面显示“Conflicts With”或“Cannot Merge”信息来提示有冲突。

处理方式1:

  • 简单粗暴地直接取消有冲突的提交,在需要修改时重新提交一个。

处理方式2:

  1. 在本地执行git fetch命令更新最新的远端代码
  2. 执行git rebase命令获取具体的冲突信息
  3. 执行git mergetool命令手动解决冲突
  4. 执行git add指令重新添加修改的文件
  5. 执行git rebase -continue命令完成rebase过程
  6. 重新提交

获取命令的用法帮助信息

git fetch -h
git rebase -h
git rmergetool -h
git add -h

7 - 为Gerrit项目创建和删除分支

Gerrit和GitLab集成后,在Gerrit上创建分支,GitLab也会自动同步该分支。
但只能是单项同步(Gerrit--》GitLab),也就是说直接在GitLab上创建的分支不会自动同步到Gerrit上。
建议在Gerrit和GitLab集成后,所有的操作都在Gerrit上完成。

7.1 查看已有分支

7.2 创建新分支


7.3 删除分支

点击要删除分支一行的DETELE按钮,根据提示操作即可。

8 - 为Gerrit项目添加默认代码审核人

一般情况下,每次提交时都需要手工添加Code Reviewer。
通过reviewers插件,可以为指定项目或分支设置默认的Code Reviewer,在有代码提交时,Code Reviewer会接收到代码审核通知邮件。

8.1 找到reviewers插件

在GerritForge(https://gerrit-ci.gerritforge.com/),找到对应gerrit 版本的reviewers插件

reviewers插件:
https://gerrit-ci.gerritforge.com/job/plugin-reviewers-bazel-master/

获得对应的jar下载地址
https://gerrit-ci.gerritforge.com/job/plugin-reviewers-bazel-master/lastSuccessfulBuild/artifact/bazel-bin/plugins/reviewers/reviewers.jar

8.2 放置插件并重启Gerrit服务

将下载的插件(jar包)放置在$GERRIT_SITE/plugins目录下,然后重启Gerrit服务($GERRIT_SITE/bin/gerrit.sh restart),会自动加载此目录下的插件。

[gerrit@mt101 ~]$ cd gerrit_testsite/plugins/
[gerrit@mt101 plugins]$ pwd
/home/gerrit/gerrit_testsite/plugins
[gerrit@mt101 plugins]$ wget https://gerrit-ci.gerritforge.com/job/plugin-reviewers-bazel-master/lastSuccessfulBuild/artifact/bazel-bin/plugins/reviewers/reviewers.jar
--2019-12-11 11:55:16--  https://gerrit-ci.gerritforge.com/job/plugin-reviewers-bazel-master/lastSuccessfulBuild/artifact/bazel-bin/plugins/reviewers/reviewers.jar
Resolving gerrit-ci.gerritforge.com (gerrit-ci.gerritforge.com)... 8.26.94.23
Connecting to gerrit-ci.gerritforge.com (gerrit-ci.gerritforge.com)|8.26.94.23|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 41911 (41K) [application/java-archive]
Saving to: ‘reviewers.jar’
​
100%[==========================================>] 41,911       118KB/s   in 0.3s   
​
2019-12-11 11:55:23 (118 KB/s) - ‘reviewers.jar’ saved [41911/41911]
​
[gerrit@mt101 plugins]$ 
[gerrit@mt101 plugins]$ chmod 755 reviewers.jar 
[gerrit@mt101 plugins]$ ll
total 44
-rwxr-xr-x 1 gerrit gerrit 41911 Nov 16 02:03 reviewers.jar
[gerrit@mt101 plugins]$ 
[gerrit@mt101 plugins]$ cd
[gerrit@mt101 ~]$ sudo sh gerrit_testsite/bin/gerrit.sh restart
Stopping Gerrit Code Review: OK
Starting Gerrit Code Review: OK
[gerrit@mt101 ~]$

8.3 查看插件是否安装成功

8.4 配置Reviewers


Filter部分:"*"表示所有分支改动

Reviewer部分:自动提示支持的用户名、邮箱名、群组名

9 - 手动同步GitLab代码到Gerrit

Gerrit和GitLab集成后,在Gerrit上创建分支,GitLab也会自动同步该分支。
但只能是单项同步(Gerrit--》GitLab),也就是说直接在GitLab上创建的分支不会自动同步到Gerrit上。
建议在Gerrit和GitLab集成后,所有的操作都在Gerrit上完成。

如果不小心在GitLab端进行了代码的更新操作,就需要手工执行同步代码的命令。

cd /home/gerrit/gerrit_testsite/git/${project}
git fetch origin +refs/heads/*:refs/heads/* +refs/heads/*:refs/heads/* --prune

10 - 删除Gerrit上的项目

为防止误操作,在Gerrit界面无法直接删除项目。

可以在后台将项目目录删除,然后刷新缓存,才可以完全移除。

[gerrit@mt101 git]$ pwd
/home/gerrit/gerrit_testsite/git
[gerrit@mt101 git]$ ll
total 0
drwxr-xr-x 7 gerrit gerrit 119 Dec 10 14:43 All-Projects.git
drwxr-xr-x 7 gerrit gerrit 119 Dec 11 12:26 All-Users.git
drwxr-xr-x 7 gerrit gerrit 138 Dec 11 12:45 testrepo.git
[gerrit@mt101 git]$ 
[gerrit@mt101 git]$ rm -rf testrepo.git/
[gerrit@mt101 git]$ 
[gerrit@mt101 git]$ ssh -p 29418 admin@192.168.16.101 gerrit flush-caches --all
[gerrit@mt101 git]$

刷新页面


Action is the antidote to despair!

欢迎转载和引用,但请在明显处保留原文链接和原作者信息!
本博客内容多为个人工作与学习的记录,少部分内容来自于网络并略有修改,已尽力标明原文链接和转载说明。如有冒犯,即刻删除!

以所舍,求所获,有所依,方所成。
  • 0
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值