JIRA与FishEye集成指南
上海方外网络科技有限公司
Digital Talent Technology Co., Ltd.
https://www.wendangku.net/doc/5a5673744.html,
2009年2月
目 录
第一章、前言 (1)
1.1 版权声明 (1)
1.2 内容 (1)
1.3 参考 (1)
1.4 联系我们 (1)
第二章:开始准备 (1)
2.1 安装JDK (1)
2.2 下载安装JIRA (2)
2.3 下载安装C RUCIBLE (2)
第三章:配置信任应用 (2)
3.1 在JIRA 系统中配置信任应用 (2)
3.2 在F ISH E YE 系统中配置信任应用 (3)
3.3 启用F ISH E YE 远程API ......................................................................................................................................4 第四章:配置JIRA FISHEYE 插件.. (6)
4.1 F ISH E YE 基础配置 (6)
4.2. 映射版本库 (8)
第五章:FISHEYE 插件应用 (8)
5.1 将JIRA 问题关联到代码库中的文件 (8)
5.2 查看项目的活动图 (9)
5.3 监视最近提交活动 (10)
5.4 监视代码质量 (11)
第六章:参考资料 (14)
第七章、综合解决方案................................................................................................................................................15 上海方
外网络上
海方外网络上
海方外网络
第一章、前言
JIRA 作为专业的缺陷跟踪管理软件,能够在产品开发和项目管理过程中为用户提供缺陷以及任务的跟踪管理;FishEye 是一个源代码库深度查看工具软件,它可以挖掘源代码库中的有用信息,呈现在Web 浏览器界面上。JIRA 与FishEye 集成之后,可以通过FishEye 将源代码库信息与JIRA 系统中的缺陷或问题关联起来;并可以实现利用Crucible 进行代码评审过程。从而有助于产品或项目的开发和测试团队的协作,提高产品质
量、加强项目管理。
1.1 版权声明 Copyright 上海方外网络科技有限公司 版权所有。
未经上海方外网络科技有限公司书面许可,不得以任何方式转载、复制或节录本文档中的部分或全部内容。版权所有,侵权必究。
1.2 内容
本文档主要介绍JIRA 与FishEye 集成设置,通过FishEye 源代码深度查看工具,帮助您全面了解您的代码库;为JIRA 与FishEye 集成用户的使用提供参考和指南。
1.3 参考
[1] Digital Talent Technology Website
URL :https://www.wendangku.net/doc/5a5673744.html,/
[2] FishEye Features
URL :https://www.wendangku.net/doc/5a5673744.html,/software/fisheye/features.htm 1.4 联系我们
Email :support@https://www.wendangku.net/doc/5a5673744.html,
第二章:开始准备
2.1 安装JDK
1. 安装JA V A 运行时环境,如:JDK 最新安装包下载地址: https://www.wendangku.net/doc/5a5673744.html,/javase/downloads/index.jsp
注意:安装目录中不要带有空格,如:可将JDK 安装到C :盘根目录下。
2. 设置JA V A_HOME 环境变量;参考链接如下: 上海方
外网络上
海方外网络上
海方外网络
https://www.wendangku.net/doc/5a5673744.html,/software/jira/docs/java.html
2.2 下载安装JIRA
JIRA 的安装过程,可参考如下文档链接: https://www.wendangku.net/doc/5a5673744.html,/software/jira/docs/install.html
JIRA 最新安装包下载地址: https://www.wendangku.net/doc/5a5673744.html,/software/jira/jiradownloadcenter.htm
2.3 下载安装Crucible
Crucible 安装中包含了FishEye 的全部功能,因此安装Crucible 就不必再安装FishEye 了。安装过程参见相关文档,Crucible 最新安装包下载地址: https://www.wendangku.net/doc/5a5673744.html,/software/crucible/crucibledownloadcenter.htm
第三章:配置信任应用
3.1 在JIRA 系统中配置信任应用
以JIRA 系统管理员帐号登录系统,点击“管理”菜单,进入JIRA 系统的后台管理界面,找到“System ”菜单,点击“Trusted Applications ”,出现类似如下界面,在*Base URL 输入框中输入信任应用的URL 地址。为了集成FishEye ,可输入FishEye 的Base URL ,如:http://localhost:8060/ 然后点击“Send Request ”按钮。
点击“Send Request ”按钮,出现类似如下界面: 上海方外网络上
海方外网络上海方外网络
点击“增加”按钮,完成增加信任应用。出现类似如下界面:
3.2 在FishEye 系统中配置信任应用
以FishEye 系统管理员帐号登录系统。点击“Global Settings ”下面的“Trusted Applications ”菜单,出现类似如下界面: 上海方
外网络上海方外网络上海方外网络
点击“Add a Trusted Application ”链接,出现类似如下界面:
在URL 输入框中输入 http://localhost:8080/ 然后点击“Get Id ”按钮。出现类似如下界面,在界面上的Id 框中显示出获得的JIRA Id 值。点击“Save ”按钮保存信任应用的配置。
3.3 启用FishEye 远程API
在FishEye 后台管理界面上,点击“Global Settings ”下的“Server Settings ”菜单,界面右侧出现类似如下界面: 上海方外网络上海方外网络上
海方外网络
点击“Edit Settings ”链接,出现类似如下界面:
在界面上将Allow remote API calls 选项设置为“On ”,点击“Update ”按钮。
上海方
外网络上
海方外网络上海方外网络
第四章:配置JIRA FishEye 插件
4.1 FishEye 基础配置
以JIRA 系统管理员帐号登录系统,点击“管理”菜单,进入JIRA 系统的后台管理界面,找到“Global Settings ”菜单,点击“FishEye Configurations ”,如下图所示:
在界面右侧点击“Setup FishEye ”按钮,出现类似如下界面。在界面上填写FishEye URL 、API URL 、FishEye Username 、FishEye Password 、Character set 、Enable Crucible Integration 参数选项。然后点击“Map Repositories ”按钮。 上
海方外网络上
海方外网络上
海方外网络
上海方
外网络上
海方外网络上
海方外网络
4.2. 映射版本库
在JIRA 系统中配置完FishEye 后,点击“Map Repositories ”按钮后,出现类似如下界面: 在“Mapped Project Keys ”输入框中输入JIRA 系统中项目关键字,点击“更新”按钮。即:将public 版本库映射到某个项目上。出现类似如下界面: 上图表明版本库public 映射到关键字为TEST 的项目上了。
第五章:FishEye 插件应用 5.1 将JIRA 问题关联到代码库中的文件
当向源代码库中提交文件的过程中,在提交消息中输入相关的JIRA 问题关键字,如JIRA-1234。JIRA FishEye 插件会自动将提交的源代码文件和JIRA 问题关联起来。并在JIRA 问题的详细信息界面上的FishEye Tab 上显示出来。如下图所示: 上
海方外网络上
海方外网络上
海方外网络
在JIRA 系统中,通过参考链接可以直接跳转到FishEye 。在FishEye 系统中,可以利用其强大的搜索功能来搜索您的整个源代码库。访问变更历史,diffs 或通过FishEye 下载源代码文件等等。
5.2 查看项目的活动图 利用JIRA FishEye 插件还可以查看项目的提交历史和活动统计图,那些人提交了多少代码文件?哪些问题引起了最多代码修改?这些数据都是实时最新的,通过图表的方式显示出来。如下图所示界面: 上
海方外网络上
海方外网络上
海方外网络
5.3 监视最近提交活动
通过定制JIRA 的数字面板,在数字面板上添加FishEye Portlet ,显示指定项目或整个代码库的提交活动情况: 上海方
外网络上
海方外网络上
海方外网络
5.4 监视代码质量 在JIRA 数字面板上通过Crucible 评审度量来监视代码质量。目前,Crucible 提供了如下一些图表: z Open Reviews 上海方
外网络上海方外网络上
海方外网络
z Open Review Age
z Defect Classification 上
海方外网络上
海方外网络上海方外网络
z Defect Rank
z Comment Volume 上
海方外网络上海方外网络上
海方外网络
所有这些图表都可以按照项目和进行配置,并可设定时间周期来筛选结果。
第六章:参考资料 1. FishEye 功能介绍:
https://www.wendangku.net/doc/5a5673744.html,/software/fisheye/features.htm 2. JIRA 在线演示站点:
https://www.wendangku.net/doc/5a5673744.html,/
上
海方外网络上
海方外网络上
海方外网络
第七章、综合解决方案
Crowd – 专业的缺陷(bug)跟踪管理软件(Issue Tracker);
Confluence - 专业的(wiki)企业知识管理与协作软件;
Bamboo - 持续集成构建服务器软件(Build Server);
Crowd - 单点登录认证(SSO)应用软件;
Clover - 强大并可高度配置的代码覆盖分析工具(Test with Confidence ); Crucible - 有效的代码评审工具(Efficient Code Review );
FishEye - 源代码深度察看工具(Source Code Repository Insight ); GreenHopper – JIRA 的插件,用于敏捷开发和项目管理(Agile project management for JIRA ); 各产品之间可以根据客户需求相互组合,以发挥更为强大的作用。 更多关于产品解决方案的信息,请参考如下链接: https://www.wendangku.net/doc/5a5673744.html,/solution/default.htm 上海方
外网络上海方外网络上
海方外网络