1 安装禅道
1.1  选择适合您的安装方法
1.2  使用云禅道在线项目管理服务!
1.3  (推荐)windows用一键安装包安装
1.4  (推荐)linux用一键安装包
1.5  linux下用lampp集成包安装
1.6  使用源码包安装(MAC系统)
1.7  MAC下用XAMPP安装禅道
1.8  MAC下用XAMPP-VM安装禅道
1.9  禅道一键安装包里安装蝉知和ZDOO
1.10  使用源码包安装(各系统通用)
1.11  宝塔面板安装禅道
1.12  华芸NAS在线安装
1.13  Centos7.4系统下安装httpd,mariadb,php7.2环境运行禅道
1.14  Centos8系统下安装httpd,mariadb,php7.2环境运行禅道
1.15  安装ioncube扩展
1.16  Docker方式部署禅道
2 禅道介绍
2.1  关于禅道项目管理软件
2.2  禅道介绍PPT下载
2.3  如何获得支持
2.4  关注我们
3 升级禅道
3.1  选择和自己环境对应的升级方式
3.2  通过源代码方式升级(通用)
3.3  windows一键安装包的升级
3.4  linux一键安装包升级
4 创建分组和用户
4.1  建立部门结构
4.2  添加一个用户帐号
4.3  批量维护帐号
4.4  设置分组,建立权限体系
5 最简使用
5.1  使用禅道来进行项目任务管理
5.2  只使用禅道来做bug管理
5.3  只使用禅道来进行产品管理
5.4  个人使用禅道来做事务跟踪管理
6 基本使用
6.1  禅道使用的基本流程和产品、研发、测试之间的三权分立
6.2  敏捷开发及scrum简介
6.3  禅道和scrum的对应关系
6.4  禅道的新手教程
6.5  创建第一个产品
6.6  添加第一个需求
6.7  开始第一个项目
6.8  确定项目要完成的需求列表
6.9  为需求分解任务
6.10  提交bug
6.11  视频教程:第一个演示项目
6.12  维护联系人
6.13  禅道的自定义功能
6.14  导入excel、csv参考文档
6.15  文档管理
6.16  工作方式的切换
6.17  操作获取积分功能
6.18  自定义必填项功能
6.19  如何排查产品、项目是否有访问权限
6.20  年度总结,工作内容统计一览表说明
7 进阶使用
7.1 使用流程
7.1.1  禅道使用流程图解
7.2 个人管理
7.2.1  使用待办进行个人事务管理
7.2.2  关注需要自己处理的任务、需求、bug
7.2.3  通过我的档案查看或者修改个人信息
7.2.4  视频教程:禅道使用之个人篇
7.3 产品经理篇
7.3.1  维护产品
7.3.2  维护产品线
7.3.3  创建和评审需求
7.3.4  变更和评审需求
7.3.5  需求的状态和研发阶段
7.3.6  需求的注意事项
7.3.7  维护产品模块
7.3.8  建立发布计划
7.3.9  建立发布
7.3.10  路线图
7.3.11  文档管理
7.3.12  主持产品会议
7.3.13  参与项目管理、演示和总结
7.3.14  需求的基本统计报表
7.3.15  视频教程:禅道使用之产品经理篇
7.4 项目经理篇
7.4.1  建立项目
7.4.2  组建项目团队
7.4.3  确定项目要完成的需求列表
7.4.4  组织进行任务分解
7.4.5  召开每天的站立会议
7.4.6  通过燃尽图了解项目的进展
7.4.7  通过各种列表的各种功能了解项目进展
7.4.8  召开演示会议和总结会议
7.4.9  项目任务基本的报表统计
7.4.10  视频教程:禅道使用之项目经理篇
7.5 开发团队篇
7.5.1  参加项目计划会议,分解任务
7.5.2  领取任务,并每天更新任务
7.5.3  通过看板和树状图查看任务
7.5.4  创建版本
7.5.5  申请测试
7.5.6  解决bug
7.5.7  文档管理
7.5.8  确认bug
7.5.9  视频教程:禅道使用之开发团队篇
7.6 测试团队篇
7.6.1  维护bug视图模块
7.6.2  提交bug
7.6.3  验证bug,关闭
7.6.4  激活bug
7.6.5  找到自己需要的bug
7.6.6  维护测试用例视图
7.6.7  创建测试用例
7.6.8  测试套件、报告和公共用例库的维护
7.6.9  管理测试版本
7.6.10  执行用例,提交Bug
7.6.11  查看报表统计
7.6.12  视频教程:禅道使用之测试团队篇
8 维护配置
8.1 维护禅道
8.1.1  初始化管理脚本
8.1.2  备份禅道
8.1.3  恢复删除的资源
8.1.4  如何更新燃尽图
8.1.5  一键安装包如何实现mysql异机连接
8.2 配置禅道
8.2.1  设置是否允许匿名访问
8.2.2  如何配置email发信
8.2.3  禅道云发信
8.2.4  如何成为超级管理员
8.2.5  配置禅道系统为静态访问
8.2.6  去掉禅道访问地址中的zentao
8.2.7  集成禅道和svn
8.2.8  集成禅道和git
8.2.9  在第三方应用中集成禅道
8.2.10  第三方应用配置免密登录禅道
8.2.11  第三方应用集成禅道客户端进行消息通知
8.2.12  集成webhook
8.2.13  集成ZDOO
8.2.14  客户端集成
8.2.15  禅道的翻译功能
8.2.16  浏览器通知的设置
8.2.17  集成钉钉工作消息通知
8.2.18  企业微信群机器人
8.2.19  集成企业微信应用消息通知
8.2.20  集成版本库、集成Jenkins,并进行构建
9 定制开发
9.1  二次开发机制
9.2  禅道的目录结构
9.3  找到要修改的文件
9.4  禅道的数据库结构
9.5  公用模块--common
9.6  如何登记菜单
9.7  如何登记权限
9.8  示例:如何修改禅道的语言提示?
9.9  示例:创建bug时可以设置优先级字段
9.10  使用在线扩展编辑器
9.11  二次开发编辑器和翻译功能限制使用说明
9.12  禅道项目管理软件打包规范1.1版本
10 其他相关
10.1  禅道所使用到的第三方代码
10.2  禅道FAQ
10.3  如何帮助禅道项目
10.4  禅道商业服务
10.5  禅道项目的贡献者
10.6  历史修改记录

集成版本库、集成Jenkins,并进行构建

2020-03-11 09:05:31
王怡栋
5814
最后编辑:石洋洋 于 2020-07-02 17:26:41

禅道开源版12.1版本开始,增加了集成功能,可以集成Jenkins,并调用Jenkins进行构建。


一、创建代码版本库

最新版本的禅道,进入代码视图,默认是需要先创建版本库。

只有创建了版本库成功了,才可以使用代码。

  • 名称即subversion库的名字。
  • 地址是subversion库的访问路径,比如http://zentaoms.goglecode.com/svn,不一定是根路径,可以是某一个下级路径。
  • subversion库文件的编码。
  • 客户端软件的地址。linux下面可能是/usr/bin/svn(git可能是/usr/bin/git),需要将svn版本升级到1.9以上。windows可以下载 sliksvn(Windows一件安装包中已经集成)的客户端(git请使用 msysGit),然后指定svn.exe的路径。( 特别提醒:1、客户端需要和禅道放在同一台服务器上;2、客户端的路径中不能包含空格和中文;3、如果要使用https协议,需要保证https证书的合法性,后面不能直接跟ip地址;4、git仓库必须和禅道在同一台电脑上,地址栏直接写仓库的文件目录即可。
  • 用户名和密码。如果不需要用户名和密码的,置空就可以了。

编辑保存之后,系统会进行初始化,获得历次的修改记录。

二、浏览版本库

配置完成之后,就可以浏览subversion的库了。

点击右上角的 刷新 按钮,即可同步代码。

三、查看文件,进行比对

四、集成Jenkins

1、安装Jenkins

安装文档 : https://jenkins.io/zh/doc/book/installing/

注意:安装时间可能比较长,需要安装一些插件。

配置Jenkins


执行的构建Shell


GIT
	===Jenkins构建后命令===
	echo "PARAM_TAG = $PARAM_TAG";
	echo "PARAM_REVISION = $PARAM_REVISION";
	[ -z ${PARAM_TAG} ] || git checkout "${PARAM_TAG}"
	[ -z ${PARAM_REVISION} ] || git checkout "${PARAM_REVISION}"
	cat README
	===说明===
		参数
		PARAM_TAG:tag名
		PARAM_REVISION:revison编号
		初始化
		git clone https://gitee.com/aaronchen2k/ci_test.git
		构建tag
		export PARAM_TAG=tag111
		[ -z ${PARAM_TAG} ] || git checkout "${PARAM_TAG}"
		构建revision
		export PARAM_REVISION=6c3a7bf931855842e261c7991bb143c1e0c3fb19
		[ -z ${PARAM_REVISION} ] || git checkout "${PARAM_REVISION}"
SVN
	===Jenkins构建后命令===
	echo "PARAM_TAG = $PARAM_TAG";
	echo "PARAM_REVISION = $PARAM_REVISION";
	svn upgrade
	[ -z ${PARAM_TAG} ] || svn switch --ignore-ancestry "${PARAM_TAG}" 
	[ -z ${PARAM_REVISION} ] || svn up -r "${PARAM_REVISION}" 
	cat README
	===说明===
		参数
		PARAM_TAG:tag url
		PARAM_REVISION:revison数字
		初始化
		svn checkout --username aaronchen2k --password P2ssw0rd svn://svnbucket.com/aaronchen2k/ci_test_svn/trunk/ .
		构建tag
	    export PARAM_TAG=svn://svnbucket.com/aaronchen2k/ci_test_svn/tags/tag111
	    [ -z ${PARAM_REVISION} ] || svn upgrade
		[ -z ${PARAM_TAG} ] || svn switch --ignore-ancestry "${PARAM_TAG}" 
		构建revision
		export PARAM_REVISION=9
		[ -z ${PARAM_REVISION} ] || svn upgrade
		[ -z ${PARAM_REVISION} ] || svn up -r "${PARAM_REVISION}"

注意:

如果 jenkins 版本比较高( 在Jenkins启动前加入相关取消保护的参数配置后启动Jenkins,即可关闭CSRF):



-Dhudson.security.csrf.GlobalCrumbIssuerConfiguration=false


参考资料

https://unix.stackexchange.com/questions/444177/how-to-disable-the-csrf-protection-in-jenkins-by-default

http://www.likecs.com/show-105574.html

a. Jenkins若是跑在Tomcat下,只需在tomcat启动脚本中加入配置即可;若是以jar包形式部署的,只需在启动时加上配置参数即可。

b. 如果docker部署的话,需要配置下java环境变量


FROM jenkins/jenkins:latest
ENV JAVA_OPTS -Djava.net.preferIPv4Stack=true -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration=false


2、集成Jenkins

五、执行构建任务

1、添加构建任务

注意:

如果遇到 jenkins服务器选择后jenkins任务是空的(前提是jenkins中的确有任务存在),到jenkins全局设置中把“匿名用户具有可读权限”前面打上对号:


触发方式:

GIT打标签:GIT版本库当有新tag的时候,执行构建任务。

SVN 监控目录:当SVN监控目录中有目录变动的时候,执行构建任务。


提交注释包含关键字:当检测版本库的注释里面包含设置关键字的时候,执行构建任务。

定时计划:会在设置的日期和时间,执行构建定时任务

2、执行构建

为了成功构建任务,必须保证计划任务开启,并且保证下图的三个计划任务正常

手动 构建

3、构建历史

构建 日志


六、设置指令

系统会根据设置的指令,解析版本库的注释。根据解析结果对匹配的任务做处理。

该功能必须确保下面两个定时任务是正常的。



评论列表
hxy 2020-06-24 15:38:56
禅道里的参数如何注入到jenkins 参数化构建中
禅道-Bee 2020-06-24 17:00:17
目前没有这种功能,这块我们也反馈下。
pilgrima 2020-06-19 14:40:19
这个文档中间过程缺少文字说明啊,不知道有些操作用意是什么,我这边jenkins构建maven项目,在jenkins里可以构建,加到禅道一直报“发送执行请求成功!执行结果:创建失败”
石洋洋 2020-06-19 15:04:28
1、本文档中操作步骤的添加字符参数添加了吗?
2、如果添加了找一下php日志看看有什么错误记录:zentao(pro/ep/pms)/config/my.php中debug的值改成true 重新操作一下 看日志文件 zentao(pms/ep/pro)/tmp/log/php开头的今天的文件有什么报错。注:不要找sql开头的文件。
3、如果还解决不了的话,可以加一下本网页最上方的QQ或者电话微信邀请入群后一起截图看一下。
billy 2020-06-15 16:47:04
你好,请问,使用jekins跑完任务后,用例执行的结果(成功,失败等)可以自动回填吗
石洋洋 2020-06-15 17:47:56
方案一:目前是可以把执行结果读取到集成-构建页面点击构建历史的日志按钮,可以查看执行的结果,然后手动录入结果的。
方案二:在jenkins调用的时候可以调用 ztf进行测试(https://ztesting.net/),测试后可以设置由ztf自动把执行结果同步到禅道用例中。
chandaouser 2020-04-24 10:52:34
请问开源版本的集成jenkins功能,可否不配置代码和版本库,仅调用jenkins服务器进行手动构建?
我看到构建任务里,代码库是必填项
禅道-Bee 2020-04-24 15:44:11
可以联系下官网顶部的商务QQ,邀请加入技术交流群,群里具体截图看下。
2020-03-31 22:42:35
在 代码 处 刷新 没有动静,错误日志
cat ../zbox/logs/apache_error.log
error: could not lock config file .git/config: Permission denied
error: could not lock config file .git/config: Permission denied

目录下 有.git/config文件 即使 给 777权限也一样
禅道-Bee 2020-04-01 08:57:19
应该还是权限问题导致的,建议联系下官网顶部的商务QQ,邀请加入禅道技术交流群,群里沟通下,方便截图确认问题。
freedomskying 2020-03-25 08:49:07
按照提示创建jenkins构建任务,但是手工执行的时候,报错,创建失败,这是什么原因啊?
禅道-Bee 2020-03-25 08:53:08
可以联系下官网顶部的商务QQ,邀请加入技术交流群,群里具体截图看下操作过程。
s1mple 2020-03-23 17:07:49
你好,麻烦问下,我有这样一种情况:我在内网部署了一套禅道以及禅道客户端,并且部署了一套jenkins,我想在我的jenkins任务结束后通过禅道客户端发送消息给相应的人员。这个情况请问当前版本是否实现了?
闫敏 2020-03-23 17:13:23
目前版本 jenkins 还没有触发通知的功能,可以关注下后续版本发布的更新内容
萧生 2020-03-18 17:34:29
集成jenkins,手动执行构建,提示“发送执行请求成功!执行结果:创建失败”
闫敏 2020-03-18 17:39:48
可以通过官网的qq 添加技术交流群里,将问题截图看下
rainy 2020-03-20 11:05:56
我也是出现这种情况,不知道是哪里出了问题
石洋洋 2020-03-20 15:57:21
直接用本文档提供的shell也不可以吗?可以加一下本网页最上方的QQ或者电话,邀请入群后一起看一下。
王智涛 2020-03-17 19:02:45
你好,我这边使用源码安装方式,但是集成git配置,添加完之后,提示保存成功,但是并没有列出代码库,可能是什么原因?
还有我看了教程,说是有一个syncgit.sh,这个脚本我也没有找到。
难道是必须要一键安装版本才行么?
石洋洋 2020-03-18 09:18:32
这块需要确认贵公司具体的操作内容及结果,可以加一下本网页最上方的qq或者电话,邀请入群后一起看一下。
loper 2020-03-17 17:12:21
您好,这边升级了版本,打开Jenkins页面报错如下,麻烦帮解决下,谢谢

09:02:38 ERROR: the control file /opt/zbox/app/zentao/module/jenkins/control.php not found. in /opt/zbox/app/zentao/framework/base/router.class.php on line 1219, last called by /opt/zbox/app/zentao/framework/router.class.php on line 317 through function setControlFile.
in /opt/zbox/app/zentao/framework/base/router.class.php on line 2224 when visiting jenkins-browse
禅道-Bee 2020-03-17 17:27:27
先看下有这个文件吗? /opt/zbox/app/zentao/module/jenkins/control.php ,另外,看下升级包中,有zentapmso/module/jenkins/control.php 这个文件吗?
1/2
发表评论
评论通过审核后显示。