SCMLife.com

 找回密码
 立即注册

QQ登录

只需一步,快速开始

扫一扫,访问微社区

查看: 4226|回复: 0

[原创] 集成禅道和git

[复制链接]
发表于 2015-10-28 10:42:05 | 显示全部楼层 |阅读模式
禅道从5.0版本开始内置了git集成功能,把禅道的任务、Bug等与代码进行关联,方便用户查看。下面向大家讲解如何配置禅道集成git。. |, q7 l1 v7 w. Y

# o- t5 m9 d6 H一、 git集成机制说明1 s/ Q) G, L2 b' c% R+ a
git集成的基本机制是:分析提交代码时的注释 => 得出相应的story, task, bugID => 写入到禅道的数据库。
) v$ [$ a6 t+ E! e; ~" {8 ?实现上述功能有两个方案,一个方案是采用git自带的钩子机制,当有代码提交的时候,触发一个钩子脚本,然后分析注释,得出相应的bug, story或者task的id号,然后调用禅道的api,将相关的记录写入数据库。还有一个方案是通过git客户端软件的log命令,来获得所有的提交记录,然后分析,得出相应的id,写入数据库。! a" \0 i$ R. R; V; @
上述两个方案各有各自的优缺点,我们最终是选择了第二个方案。因为第二个方案调试比较好调试,部署也相对方便,同时可以解析之前的所有记录,有比较好的灵活性。5 O0 W2 Q! a4 M
- F  E6 n! l5 l+ O  u, ?. s
二、在禅道所在机器上面部署git命令行客户端" {% q6 p* t7 H; x+ S' l. D- a
git命令行客户端是指git自带的git命令。windows下面是git.exe,linux下面是没有后缀的git。
; B+ W  U) d4 V6 u! ?6 Z禅道所在的机器可以和git机器分开,不在一台机器上面。
: `3 V  V+ M, Y2 p如果是linux机器,需要安装git的客户端。rhel,centos可以用yum安装git, debian下面可以用apt-get install。
7 C9 w2 d" x1 J: K' P5 y, j2 V6 K, ~: g- }1 [
三、配置禅道关于git的参数
& e, v% P/ K' s5 W/ ^3.1 代码位置
  [7 C; q7 K# h: S" B6 xgit模块的配置文件位于zentao/module/git/config.php。您可以直接修改这个文件,但建议您将改动保存到git/ext/config/git.php中。这样将来我们升级,就不会覆盖您的配置文件。" j- I, V1 C+ A( Y, Y8 T
3.2 配置内容$ t. J% t: V$ o
1.  git客户端命令的位置。/ }8 o1 L! E3 [
2.  库(repo): 可以配置多个库。
/ N8 I# d+ d! _0 r" c* \下面让我们用实际的例子来说明。2 A/ h% R4 t4 z! p8 y
3.2.1 如下图,找到图中红框标志的位置( ?2 l$ u3 }5 {: l

4 T2 i. t+ A$ m! I/ q3.2.2 修改代码
. `# {. k0 ^4 u0 q/ \8 i# y% g写法如下面例子所示
) d( I$ t# _0 k6 V8 s
7 m. d! ?2 T" f, Y- s7 x7 Z! }$config->git->client 填写git客户端路径;4 L* m: `/ [/ |8 K8 u$ ^
$config->git->repos[$i]['path'] 填写git库的路径( |: D) h8 h1 L4 C. x- G+ V) r. r7 F
3.3 配置多个库
6 ]% Q3 [+ H* a/ F$ k2 c4 U1 _3.3.1 同上,在同一个文件里找到如下代码% y+ J, ]; Z5 A0 ~; z) _& b# r
/ H  i* j: u* w! e0 h
3.3.2 修改代码& c; {* G" S! ^- z) {: m
①将代码中的“/*”和”*/“删除,其余修改同上,注意:$i ++ 不可修改。: M5 R0 q+ Z, |4 H6 W; ?1 G
②如果还有git库,复制此段代码,进行同样的配置即可。
6 E. ~& {: q/ \+ n9 q: e7 D- ~; b) i1 ~$ b3 D
四、代码提交注释格式6 v; _- ~) P5 ]; h9 U( P
开发者在提交代码到git的时候,需要在备注里面注明此次修改相关的需求,或者任务,或者bug的id。比如下面的格式:
) l$ {8 ]# _6 x+ mbug#123,234, 1234,也可以是bug:123,234 1234,id列表之间,用逗号和空格都可以。( |5 u: d3 q. _3 @1 r# z
story#123 task#123& g: M' [0 R& }. w& V
bug, story, task是必须标注的。6 [: @! b- I# L( v% W7 I

- B1 Y% h, x# N0 c+ {! W* V! G五、执行git同步命令
) z$ Y2 {0 q  k3 T/ s5.1 参考《初始化管理脚本》这篇文章初始化命令行的脚本。
5 n+ C+ x6 C3 X; Q& F5.2 进入到zentao/bin/目录下面,执行syncgit.bat或者syncgit.sh脚本。
+ z2 n1 n7 @- j9 [5 S5.3  程序运行的效果图:8 h/ q' _+ r' ?
, Z7 S6 ~, n  Z, }2 o
5.4 查看相应的bug:
# Q$ z- V! c! X  V) C7 V5 }' q# ]7 H+ A* K& r; N, B

1 Q+ m( _9 Q4 r. c六、部署定时任务
8 N* P  j7 i' @3 J. g1 ?6.1 上述命令部署好之后,将该命令加入定时任务。比如可以5分钟执行一次。windows下面使用计划任务,linux下面使用crontab。
- U9 F- F: y+ O6.2 配置的代码库也要使用定时任务同步更新,每隔5分钟git pull一下。( ~5 I# H, e; Y' ]& T3 e
" v' A1 c- Z% E. T# c

本帖子中包含更多资源

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

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

本版积分规则

关闭

SCMLife推荐上一条 /5 下一条

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

GMT+8, 2020-4-9 07:34 , Processed in 0.064705 second(s), 9 queries , Gzip On, MemCache On.

Powered by SCMLife X3.4 Licensed

© 2001-2017 JoyShare.

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