统一服务热线 4006-8899-23
English
配置禅道

集成禅道和git 分享链接 /book/zentaopms/207.html?releaseID=17

作者：朱金勇 最后编辑：苏萌 于 2023-12-20 09:00:10 浏览量：194629
摘要：禅道内置Git集成功能，通过配置禅道集成Git，可以把禅道中的任务、禅道中的Bug等与代码相关联，方便用户查看。

本篇目录

禅道从5.0版本开始内置了git集成功能，把禅道的任务、Bug等与代码进行关联，方便用户查看。下面向大家讲解如何配置禅道集成git。

一、 git集成机制说明

git集成的基本机制是：分析提交代码时的注释 => 得出相应的story, task, bugID => 写入到禅道的数据库。
实现上述功能有两个方案，一个方案是采用git自带的钩子机制，当有代码提交的时候，触发一个钩子脚本，然后分析注释，得出相应的bug, story或者task的id号，然后调用禅道的api，将相关的记录写入数据库。还有一个方案是通过git客户端软件的log命令，来获得所有的提交记录，然后分析，得出相应的id，写入数据库。
上述两个方案各有各自的优缺点，我们终是选择了第二个方案。因为第二个方案调试比较好调试，部署也相对方便，同时可以解析之前的所有记录，有比较好的灵活性。

二、在禅道所在机器上面部署git命令行客户端。

git命令行客户端是指git自带的git命令。windows下面是git.exe，linux下面是没有后缀的git。
目前禅道只能集成禅道所在的机器上的git仓库，如果是远程仓库需要在禅道所在机器上克隆一个仓库（需要定时同步数据）进行集成。
如果是linux机器，需要安装git的客户端。rhel,centos可以用yum安装git, debian下面可以用apt-get install。

三、配置禅道关于git的参数

从禅道开源版12.1版本开始，配置GIT代码库方法是：请使用管理员登录禅道，在集成 - 代码库 中进行配置（具体方法在 https://www.zentao.net/book/zentaopmshelp/393.html集成版本库、集成Jenkins，并进行构建），无须再按步骤三操作，配置好后看步骤四。

3.1 代码位置
git模块的配置文件位于zentao/module/git/config.php。您可以直接修改这个文件，但建议您将改动保存到git/ext/config/git.php中。这样将来我们升级，就不会覆盖您的配置文件。
3.2 配置内容
1.  git客户端命令的位置。
2.  库(repo): 可以配置多个库。
下面让我们用实际的例子来说明。
3.2.1 如下图，找到图中红框标志的位置

3.2.2 修改代码
写法如下面例子所示

$config->git->client 填写git客户端路径；
$config->git->repos[$i]['path'] 填写git库的路径
3.3 配置多个库
3.3.1 同上，在同一个文件里找到如下代码

3.3.2 修改代码
①将代码中的“/*”和”*/“删除，其余修改同上，注意：$i ++ 不可修改。
②如果还有git库，复制此段代码，进行同样的配置即可。

四、代码提交注释格式

开发者在提交代码到git的时候，需要在备注里面注明此次修改相关的需求，或者任务，或者bug的id。比如下面的格式：
bug#123,234, 1234，也可以是bug:123,234 1234，id列表之间，用逗号和空格都可以。
story#123 task#123
bug, story, task是必须标注的。:)

五、执行git同步命令

如管理员登录禅道后，有后台 - 系统 - 定时功能，则根据实际情况在这里设置执行时间周期即可(moduleName=git)

5.1 参考《初始化管理脚本》这篇文章初始化命令行的脚本。
5.2 进入到zentao/bin/目录下面，执行syncgit.bat或者syncgit.sh脚本（如无此脚本文件，可以点击链接《初始化管理脚本》）。
5.3  程序运行的效果图:

5.4 查看相应的bug:

六、部署定时任务

6.1 上述命令部署好之后，将该命令加入定时任务。比如可以5分钟执行一次。

方案1：网页登录禅道 后台-系统-定时，开启计划任务后 点击 激活 同步git 脚本，注：修改后需要执行如下操作：后台-系统-定时 关闭 =》重启apache服务 =》 开启 后台-系统-定时。

方案2：使用操作系统自带的计划任务功能：windows下面使用控制面板-计划任务，linux下面使用crontab。

6.2 配置的代码库也要使用定时任务同步更新（需要自己写同步脚本，部署在操作系统的定时任务中），每隔5分钟git pull一下。

七、集成GitLab类型版本库

15rc3版本开始，禅道集成GitLab类型版本库。
集成成功后，可以同步版本库历史记录，进行目录浏览，代码查看、追溯、diff 功能操作。
下面给大家介绍怎么集成GitLab类型版本库。

7.1 创建GitLab类型版本库

点击DevOps--版本库页右上角的 创建 按钮，即可进入版本库的创建页面。

在类型点击下拉选择GitLab。

 接下来需要填写GitLab地址和Token。

GitLab地址：

填写GitLab里的项目所在的服务器地址，即可访问到GitLab里的项目的服务器地址。

比如我的GitLab的项目访问地址是：https://gitlab.abc.com，那么GitLab地址就填写：https://gitlab.abc.com即可。

Token：

登录GitLab在 Settings 的 Access Tokens 里按页面提示填写，生成Token即可。

按照页面提示，根据使用需要填写内容信息。

填写完信息后，点击创建按钮。

Token 创建成功后，会提示在页面顶部。


创建Token成功页面底部，还显示着之前创建成功的Token列表信息。

填写GitLab地址和Token后，项目会自动同步显示GitLab里所有项目。

可以在下拉里选择。

选择了项目后，名称会自动填充为该项目的名称，点击保存即可。

保存成功后，就开始自动同步项目的代码。

7.2 同步GitLab 项目的代码

创建版本库后，开始同步代码。


同步完成后可以在代码里查看，也可以在版本库的列表里查看到GitLab类型的版本库。


7.3 代码的查看、追溯、diff

浏览查看代码目录

追溯

比较差异（diff功能）

评论列表
🌿
孤独的跑步机 2025-02-26 17:13:51 回复
支持集成TFS TFVC吗
回复
这个不支持的
🐟
刀枪不入的弓箭 2024-08-29 16:51:20 回复
最新版本关联代码库的时候创建webhook失败，查看日志后发现是url字段无效
20240829 16:42:54: /index.php?m=repo&f=create&objectID=0
POST url: http://test.test.com/api/v4/projects/66/hooks?private_token=xxxxxxxxxxxxxxxxxxx
data: {"enable_ssl_verification":"false","url":"http:\/\/192.168.10.176:8080\/api.php\/v1\/gitlab\/webhook?repoID=1","push_events":true,"merge_requests_events":true,"token":"66d0348e5cebb"}
results:{"error":"Invalid url given"}
回复
https://www.zentao.net/book/zentaopms/547.html
看下文档中后面部分，有webhook创建失败的解决方式呢
🌠
沉稳的饼干 2024-08-27 11:24:32 回复
评论里的hash值，为什么不直接用git的，我怎么和git的提交做关联呢？
回复
git提交时以固定格式例如 task #001 "test" 进行提交注释，可以和禅道中数据进行关联的。
具体提交指令在后台-DevOps-指令中可以看到的
😼
胡子拉碴的沙滩裤 2024-06-25 17:31:00 回复
git本地仓上传代码库后，浏览界面看不到库中文件内容是为何，显示暂无。（本地git已提交且操作正常）
回复
提交的代码需要同步到禅道集成的的本地git库中，禅道才可以正常读取到。
王仙家 2023-03-08 09:10:52 回复
目前的各种说明都是介绍linux下怎么配置的，有没有windows下局域网集成GIT到禅道的操作演示的，自己折腾了大半天各种报错
回复
您好，看提示是用户不一致导致的，可以先修改下git仓库的所有者试一下，不行的话，可以添加下首页同事，邀请到禅道交流群，协助看一下。
王仙家 2023-03-07 17:11:27 回复
windows下如何实现局域网内将GIT和SVN版本管理工具集成到禅道中？
回复
对于GIT和SVN的集成，需要咱们手动搭建相应的服务，然后通过禅道中的集成做处理，具体可以参考https://www.zentao.net/book/zentaopms/549.html
🎵
禅道9390 2023-02-02 10:56:56 回复
请问一下,我已经在禅道配置与gitlab的关联，但是我通过git提交代码之后，也执行了git同步脚本，但是我再禅道任务的历史记录里没看见git的提交操作。这种情况该如何处理
回复
看下禅道命令是如何配置的?是按照命令格式提交的吗？
也可添加上方商务qq，进群看下这个问题。
回复
执行git同步命令出现:
2023-02-01 23:21:33 begin repo 1
2023-02-01 23:21:33 sync branch master logs.
2023-02-01 23:21:33 get this repo Logs.
repo #1: http:// api/v4/p roj ects/3/ repository/ finished


两种备注提交方式我都试过了:
TASK #104 测试13
TASK#104 测试12
回复
示例命令为：Start Task #1,2 Cost:1h Left:3h
添加上方商务qq，进群沟通下其他问题
王小蓉 2023-01-08 13:46:57 回复
禅道和Gitlab集成后，是否可以直接通过禅道下载代码？是否存在代码泄露风险
回复
1、在集成gitlab库时，获取的token本身是有下载代码权限的，所以集成禅道后使用这个token是可以进行下载的
2、禅道中下载代码是可以通过权限进行控制的，可以在后台-人员-权限，用户所在权限分组限制下载代码的权限。
zhou 2022-11-15 17:27:40 回复
服务器用docker部署了zentao和gitlab，gitlab能正常访问，gitlab版本为14.6，禅道中添加gitlab时报错：当前GitLab服务器地址无效或当前GitLab版本与禅道不兼容，请确认当前服务器可被访问或联系管理员升级GitLab至9.0及以上版本后重试
回复
已解决
回复
怎么解决的
回复
检查下：
1、禅道的docker容器和gitlab服务器网络是否互通
2、配置的token需要使用gitlab的root账号权限生成
如为解决，请添加左上方商务qq，进入技术交流群截图看下这个问题。
回复
可以检查下：
1、禅道的docker容器和gitlab服务器网络是否互通
2、配置的token需要使用gitlab的root账号权限生成
ls 2022-07-26 09:59:31 回复
权限都配置成可读写了，还是不行。我使用git ssh登录，并且修改了ssh端口号。这种情况下地址该怎么写呢？首页qq尚未被加，谢谢~
回复
1.集成的git是本地git还是gitlab？
2.本地git集成，选择是否为对应的本地git选项？
3.确认禅道服务器本机是否有本地代码仓库的建设呢？
4.添加的哪位对接人联系方式，我们可以确认下：）
回复
1.集成的git是本地git，在页面上做了选择本地git
2.已经建立了本地仓库，可以正常操作
3.我加qq号为2692096539的同事
谢谢~~~
回复
禅道软件-徐亚京
TEL：17663982076（微信同号）
QQ：2679672214
Email：xuyajing@cnezsoft.com
联系商务同事，给您紧急对接处理下：）
上一页1 2 3 4 5 6 7 8 9 1/10下一页
魏中显
高级客户经理
18561939726
1746749398
统一服务热线 4006-8899-23
我要提问提问有任何问题，您都可以在这里提问。 问题反馈反馈点击这里，让我们聆听您的建议与反馈。