自动提交Git branch代码评审到Review Board系统

Posted Write the code, change the wor

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了自动提交Git branch代码评审到Review Board系统相关的知识,希望对你有一定的参考价值。

背景

敏捷软件开发中,越小的反馈环,意味着软件质量越容易得到保证。

作为组件团队,我们的开发任务中,往往存在一些特性涉及到几十个功能点,开发周期持续数周或数月的情况。如何在开发过程中保证软件质量,是个很重要的话题。进行有效的细粒度的代码评审,是常见的手段之一。但是这一希望在落地时,多多少少会遇到些来自方方面面的阻力:

Review Board不支持Git branch的代码评审提交;

Git不熟,不知道怎么生产正确的patch文件来提交到Review Board上;

Review Board不会用,不知道怎么提交代码评审;

Review Board会用,但是提交过程繁琐,一两天就要提交一次,我怕麻烦;

我忘提交了代码评审了

团队的痛点就是我们努力改进的方向,我们希望有一套方案,能实现代码评审的自动提交,提交过程对开发人员透明,最大程度上减轻开发人员的心智负担,让开发人员专注于功能开发上。

实际上,这个自动化工具和实现方案已经有了,这就是本文分享的RBTool官网的用户手册有详细的文档说明,美中不足的是,没有提供一个完整的实施案例给用户参考,本文尝试填补这一块空白,疏漏之处,还望指正。

安装

本文主要关注Review Board代码评审自动提交的方案实施上,所以假设你已经有了一台可用的Review Board(后文以RB简称)服务器。RB服务器的安装、配置、使用不在赘述。

部署环境:

[email protected]:~/git/team_dev$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 10.04.3 LTS
Release:        10.04
Codename:       lucid

安装RBTool:

如果你的计算机能访问外网,安装过程很简单:

sudo easy_install -U RBTools 

 

如果不能访问外网,需要手动下载如下安装包,并依次解压、运行 sudo python setup.py install 进行安装。

https://pypi.python.org/packages/source/a/argparse/argparse-1.4.0.tar.gz

https://pypi.python.org/packages/source/s/six/six-1.8.0.tar.gz

https://pypi.python.org/packages/source/R/RBTools/RBTools-0.7.5.tar.gz

运行如下命令,查看是否安装成功:

[email protected]:~/git/team_15000_dev$ rbt -v
RBTools 0.7.5

 

配置

配置git选项reviewboard.url为你的RB服务器访问链接:

git config --global  reviewboard.url http://XXX.XXX.XXX.XXX/

 

在你的git工作区目录下,创建RBTool的配置文件.reviewboardrc,示例如下(个人信息以XXX代替)

[email protected]:~/git/team_dev$ cat .reviewboardrc 
REPOSITORY = "XXX"
REVIEWBOARD_URL = "http://XXX.XXX.XXX.XXX/"
USERNAME = "XXX"
PASSWORD = "XXX"
TARGET_GROUPS = "CalabashBro"
TRACKING_BRANCH = "origin/XXX"

 

Repository:指定RB服务器中已经配置的repository仓库名;

REVIEWBOARD_URL:指定RB服务器访问链接;

USERNAME:指定RB服务器的用户登录名;

PASSWORD:指定RB服务器的用户登录密码;

TARGET_GROUPS:指定代码评审Review request的Groups;

TRACKING_BRANCH:指定工作分支;若不指定,默认为origin/master分支;(适用于Git)

 

配置Git commit钩子脚本(如不需要自动提交代码评审功能,此步可以跳过):

[email protected]:~/git/team_dev/.git/hooks$ touch post-commit

[email protected]:~/git/team_dev/.git/hooks$ chmod +x post-commit

[email protected]:~/git/team_dev$ cat .git/hooks/post-commit
#!/bin/sh

rbt post -g -p

参数解释:

 -g:根据git commit日志自动构造RB Review request的summary信息和description信息;

-p:自动构造和发布;如未指定,会构造一个RB Review request页面,但不会发布。

应用

如果配置了Git commit钩子脚本,commit代码时,就会自动触发提交一条RB Review request:

[email protected]:~/git/team_dev$ git commit -m Demo: auto to submit RB review request
Review request #6140 posted.

http://10.46.74.230/r/6140/
http://10.46.74.230/r/6140/diff/
[gaoyun d461499] Demo: auto to submit RB review request
 2 files changed, 6 insertions(+)

 自动提交的RB Review request截图:

技术分享

如果没有配置Git commit钩子脚本,也可以在commit后,利用rbt手动提交RB Review request,比如:

指定REVISION的修改记录提交代码评审:

rbt post REVISION

指定(STARTREV,STOPREV]区间的修改记录提交代码评审:

rbt post STARTREV STOPREV

把当前未push的修改更新到已提交的代码评审请求中:

rbt post -r REVIEW_REQUEST_NUM

其他命令请参照官网的用户手册

祝玩的开心。

--EOF--


 

以上是关于自动提交Git branch代码评审到Review Board系统的主要内容,如果未能解决你的问题,请参考以下文章

idea提交代码到自己git账号的master branch

git自动提交脚本(供参考)

Git常用操作

git如何合并两个分支代码

怎么在git提交代码到远程分支

[行业关键词] review code review