自动提交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系统的主要内容,如果未能解决你的问题,请参考以下文章