SCMLife.com

 找回密码
 立即注册

QQ登录

只需一步,快速开始

扫一扫,访问微社区

查看: 4122|回复: 0

[原创] 集成禅道和git

[复制链接]
发表于 2015-10-28 10:42:05 | 显示全部楼层 |阅读模式
禅道从5.0版本开始内置了git集成功能,把禅道的任务、Bug等与代码进行关联,方便用户查看。下面向大家讲解如何配置禅道集成git。9 B: O" @  G* m: G
: B; D& V6 C4 {3 y5 _2 Y
一、 git集成机制说明/ u& k& I" v4 |7 v$ J! e
git集成的基本机制是:分析提交代码时的注释 => 得出相应的story, task, bugID => 写入到禅道的数据库。# j8 _5 l" t+ h+ Y) U
实现上述功能有两个方案,一个方案是采用git自带的钩子机制,当有代码提交的时候,触发一个钩子脚本,然后分析注释,得出相应的bug, story或者task的id号,然后调用禅道的api,将相关的记录写入数据库。还有一个方案是通过git客户端软件的log命令,来获得所有的提交记录,然后分析,得出相应的id,写入数据库。/ z, o7 ^7 _# T" C/ C4 x
上述两个方案各有各自的优缺点,我们最终是选择了第二个方案。因为第二个方案调试比较好调试,部署也相对方便,同时可以解析之前的所有记录,有比较好的灵活性。
/ e5 D1 `& `! o' i) Q( {* S- i5 r/ }1 Z' g
二、在禅道所在机器上面部署git命令行客户端
0 w2 n5 D. X  F8 W$ K* \git命令行客户端是指git自带的git命令。windows下面是git.exe,linux下面是没有后缀的git。7 k* I  Q) U0 ]/ y& d% M) ^% M
禅道所在的机器可以和git机器分开,不在一台机器上面。
8 U" c# J4 ]) ]3 |. t: x如果是linux机器,需要安装git的客户端。rhel,centos可以用yum安装git, debian下面可以用apt-get install。' A, K5 E7 P3 U. J
& x, p9 d6 k1 D+ [0 n" D( a; q7 \
三、配置禅道关于git的参数, B" x8 u7 T4 p1 ~! x
3.1 代码位置
. z  `! ?* O0 b! }$ v5 {8 K8 zgit模块的配置文件位于zentao/module/git/config.php。您可以直接修改这个文件,但建议您将改动保存到git/ext/config/git.php中。这样将来我们升级,就不会覆盖您的配置文件。: R" X: y; h- L# v& w) {1 E
3.2 配置内容
$ w1 Z$ m( o5 ?4 }1.  git客户端命令的位置。
8 h" g. B/ w( o2 s7 L& {! p2.  库(repo): 可以配置多个库。! o1 A0 A# ^6 |. U5 k$ U
下面让我们用实际的例子来说明。0 W+ Z5 i* }) m4 l0 S% ~
3.2.1 如下图,找到图中红框标志的位置
0 z8 R3 {0 }0 f2 K; n! o8 _# b: {& r; _0 U
3.2.2 修改代码
* c7 l7 P/ \5 {写法如下面例子所示
6 _0 w/ {- f% m( K& p/ g4 L
* G8 L3 L( @& {5 [4 n) p3 u# _! J$config->git->client 填写git客户端路径;! J) U6 T8 e' K, h+ d  i* o7 ~
$config->git->repos[$i]['path'] 填写git库的路径( K# t; c2 J+ t7 m2 y
3.3 配置多个库  ~$ H/ Y; s1 X/ _$ t6 s' J+ V- r. ~8 f' X4 [
3.3.1 同上,在同一个文件里找到如下代码
2 Z* e. x5 a2 e& C% ]- R) q& [! g: G; `( p
3.3.2 修改代码( V* j" u0 C  w$ e- V
①将代码中的“/*”和”*/“删除,其余修改同上,注意:$i ++ 不可修改。! s0 g6 `) Y9 P
②如果还有git库,复制此段代码,进行同样的配置即可。
: X& O# \( X4 {7 t
0 T4 p% }% }8 ~& z四、代码提交注释格式
) A: n) G) c$ [6 o2 `& X- e" p开发者在提交代码到git的时候,需要在备注里面注明此次修改相关的需求,或者任务,或者bug的id。比如下面的格式:! j# D: \/ H2 s8 b4 n& h7 X( E
bug#123,234, 1234,也可以是bug:123,234 1234,id列表之间,用逗号和空格都可以。& F( C& l. [2 M
story#123 task#123
! s( [& u1 N0 W8 W# I2 wbug, story, task是必须标注的。1 ^/ A/ ~2 ?" n6 C

3 `, Q2 L( t7 F, b  g* N五、执行git同步命令8 O$ }- y- H/ k& K' o* H
5.1 参考《初始化管理脚本》这篇文章初始化命令行的脚本。
- @$ W. \. x7 F) l5.2 进入到zentao/bin/目录下面,执行syncgit.bat或者syncgit.sh脚本。- D9 z6 _2 `3 [( k% j
5.3  程序运行的效果图:
+ ?7 i' q0 O7 @2 z& q
# q8 j- X3 |9 M5.4 查看相应的bug:. [! _5 l& D, S) I
) t3 V: Q9 @6 a; g
5 d- w8 a2 D7 M
六、部署定时任务
) y* {+ Q' s) m% S. }6.1 上述命令部署好之后,将该命令加入定时任务。比如可以5分钟执行一次。windows下面使用计划任务,linux下面使用crontab。
7 Z- o, W  J( d8 M! }6.2 配置的代码库也要使用定时任务同步更新,每隔5分钟git pull一下。
6 [  W9 \; Y6 X( C1 Z. t- p7 ~1 {9 _1 F$ q" K; c0 H' v; l

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

关闭

SCMLife推荐上一条 /5 下一条

QQ|小黑屋|手机版|无图版|SCMLife.com ( 京ICP备06056490号-1 )

GMT+8, 2020-2-24 06:08 , Processed in 0.068571 second(s), 8 queries , Gzip On, MemCache On.

Powered by SCMLife X3.4 Licensed

© 2001-2017 JoyShare.

快速回复 返回顶部 返回列表