Maven入门实战笔记10-持续集成

持续集成

概念：

持续集成就是快速且高频率地自动构建项目的所有源码，并为项目成员提供丰富的反馈信息。

其中构建包括：编译、测试、审查、打包、部署

持续集成流程：

 一次完整的集成一般包括6个步骤：

1.持续编译

2.持续数据库集成

3.持续测试

好的单元测试必须是自动化的、可重复执行的、不依赖于环境的，并且能够自我检查的

4.持续审查

Checkstyle和PMD之类的工具发现代码中的坏味道（Bad Smell）

5.持续部署

6.持续反馈

 

硬件设置：集成服务器性能越高越好

源码控制工具、自动化构建工具、自动化测试工具、持续集成软件

优秀的持续集成工具：

开源工具CruiseControl、Hudson

商业的Bamboo和TeamCity

 

Hudson简介

优点：

功能强大、界面易用，与主流构建工具、版本控制系统以及自动化测试框架都能很好集成

灵活的插件扩展框架

安装Hudson

下载：http://hudson-ci.org/  

下载文件为：hudson-3.0.0.war

运行：最简单启动方式为

java -jar hudson-3.0.0.war

 

 

启动后，访问 http://localhost:8080

停止：Ctrl+C

默认商品为8080,指定端口启动

java -jar hudson-3.0.0.war --httpPort=8082

 

 

 也可以把war包部署到各种Web容器中

 

问题：用命令行启动时，遇到下列问题：

 

       Initial setup required. Please go to the Hudson Dashboard and complete the setup.

访问hudson设置插件安装，即可（选择默认安装）

安装个插件费这么长时间。。。最后截个图

 建议装到本地

 

选择Install as Windows Service

 

 

准备Subversion仓库

常见版本控制工具：CVS、Subversion、Git、Mercurial

安装Subversion服务器软件（svnserve） 参考   svn应用笔记

常用命令：

1.查看svnserve安装

svnserve --version

 

 

 

2.创建一个Subversion仓库

 

mkdir svn-repos

svnadmin create svn-repos\account

 3.导入account项目，导入前，用mvn clean清除项目输出文件

 

 

svn import -m "initial import" . file:///d:/svn/svn-repos/account/trunk

 

 上述命令将当前目录的全部内容提交到Subversion仓库的/account/trunk路径下

 

-m选项表示提交的注释

3.启动svnserve服务

svnserve -d -r svn-repos --listen-host 0.0.0.0

-d表示将svnserve服务作为守护进程运行

 

-r表示Subversion仓库的位置

--listen-host是为了强制将svnserve绑定到IPv4地址（有些系统，svnserve会默认绑定IPv6，当Hudson使用IPv4地址访问Subversion仓库的时候就会失败）

疑问：这个命令没有指定启动哪个库，若在svn-repos下有多个库的话，是启动哪个呢？

直接用这个命令，就明白了

svnserve -d -r d://svn/svn-repos/account --listen-host 0.0.0.0

 

 

4.检查Subversion仓库内容

 

svn list svn://localhost/account/trunk

 

 

 

Hudson的基本系统设置a在创建Hudson持续集成任务之前，用户需要对Hudson系统做一些基本的配置，包括JDK安装位置和Maven安装等在内的重要信息都 必须首先配置正确。

左侧“系统管理”--->右侧“系统设置”

1.配置JDK

Name(别名)

JAVA_HOME

2.配置Maven

Name

MAVEN_HOME

3.配置MAVEN_OPTS环境变量

参考  Maven入门实战笔记01  -Xms128m -Xmx512m

最后，点击页面正文的Save按钮保存系统设置

 

创建Hudson任务

创建Hudson任务来集成Maven项目

左边“新建任务”--->填写任务的名称及类型

 对于一般Maven项目可选择

    构建一个自由风格的软件项目
    构建一个Maven 2/3 (Legacy)项目

这两项，前者不公支持Maven项目，还支持其他类型的构建工具，如Ant、Shell。

对于Maven用户来说，两者最大的不同在于前者需要用户进行多一点的配置，而后者会使用Hduson自带的Maven，且从项目的POM中获取中够的信息以免去一些配置。推荐free-style

 

Hudson任务的基本配置

1.名称和描述，当任务比较多的时候，简洁而有意义的名称及描述就十分重要

2.Discard Old Builds：该选项配置如何抛弃旧的构建

Hudson每次构建相关的文件都会保存下来，将会渐渐耗光磁盘空间，为此Hudson提供两种方式供选择：

Days to keep builds：如果其值为非空的N，就留N天之内的构建文件

Max # of builds to keep：如果#为非空，就公保留最多#个最近构建的相关文件

 上图所示配置表示最多保留10个最近的构建

3.如果有多个JDK，这里还需选择JDK版本

 

Hudson任务的源码仓库配置

在项目配置页面的Source Code Management部分，选择 Subversion，输入Subversion仓库地址 ，一般来说，其他选项保留默认值即可，如图：

 如果Subversion仓库需要认证，Hudson会提示用户输入认证信息：

 

Hudson任务的构建触发配置

在Build Triggers部分配置的是触发构建的方式。

Build after other projects are built：在其它项目构建完成后构建本项目

Bukld periodically：周期性地构建本项目

Poll SCM：周期性地轮询源码仓库，发现有更新的时候构建本项目，推荐选这个

 

既然是轮询，就需要配置轮询的频率，Hudson使用了著名的UNIX任务高度工具Cron（http://en.wikipedia.org/wiki/Cron）所使用的配置方式。这种配置方式使用5个字段表示不同的时间单位（字段之间用空格或制表符分隔）

分 ：0-59

时 ：0-23

日 ：1-31

月 ：1-12

星期几 ：0-7（0和7都表示星期天）

特殊字符：

*：星号表示匹配范围内所有值

M-N：连字符表示匹配M-N范围内的所有值，如"1-5"

A,B,...,Z：逗号表示匹配多个值，如"0,15,10"

*/X或M-N/X：范围加上斜杠表示匹配范围内能被X整除的值，如“1-10/3”，就等同于“3，6，9”

举例：

（1）****：每分钟

（2）5****：每小时中的第5分钟

（3）*/10****：每隔10分钟

（4）45 10 ** 1-5：每周一到周五的上午10点45分

（5）0,30 *  13 * 5：每月13号的每半个小时，或者每周五的每半个小时

在配置轮询的时候，还可以使用“#”添加注释，此外空白的行会被忽略。

对于一个健康的项目来说，觉见做法是：每隔10分钟轮询代码仓库（*/10 * * * *），如图

 Hudson任务的构建配置

单击Build中的Add build step下三角按钮，选择Invoke Maven2(legacy)(《Maven实践》书中写的是：Invoke top-level Maven targets),如图：

 完成后，单击Save

 

 

监视Hudson任务状态a

Hudson界面，了解各个任务的当前及历史状态，包括整体的列表显示、自定义视图、单个任务的具体信息，如构建日志和测试报告等

全局任务状态  

默认主页显示了当前服务上所有集成任务的状态，如图：

 四部分：导航菜单、、构建队列、构建状态、任务状态

任务状态：

S:任务当前状态；

第一列的球形颜色：

蓝色：任务最近一次的构建是成功的

红色：任务最近一次的构建是失败的

黄色：任务最近一次的构建表成功了，但不稳定（主要是因为有失败的测试）

灰色：任务从未被执行过或者被禁用了

如果图标闪烁，表示任务正在执行一次构建

W：天气

第二列，使用天气图标表示任务长期的一个状态

万里晴空：>80%成功

稍有乌云：60%-80%成功

乌云密布：40%-60%成功

阴雨绵绵：20%-40%成功

电闪雷鸣：<20%成功

自定义任务视图

用户可以单击默认视图All旁边的加号（+）以添加一个自定义视图

单个任务状态a

Maven项目测试报告

为了显示项目的测试结果信息，需要一些额外的配置。

maven-surefire-plugin会在项目的tqrget/surefire-reports目录下生成与JUnit兼容的XML格式测试报告，Hudson能够基于这种格式的文件生成图形化的测试报告。

 

为Hudson任务配置测试报告：

用户可以配置一个Hudson，在配置页面的Post-build Action部分选择Publish JUnit test result report选项，并且将Test report XMLs赋值为

**/target/surefire-reports/TEST-*.xml

该表达式表示匹配任意目录下target/surefire-reports/子目录中以Test-开头的XML文件，这也匹配所有maven-surefire-plugin生成的XML格式报告文件

有了上述配置后，就能在任务状态页面中看到最新的测试结果与测试结果趋势

 

配置构建命令忽略测试：

将Maven构建命令以改为：clean deploy -Dmaven.test.failure.ignore

这样失败的测试就不会导致构建失败

这种配置方式能够帮助用户区分失败的构建与不稳定的构建

 

 

Hudson用户管理

Subversion仓库，默认该仓库是匿名可读的，认证用户可写，

现在关闭匿名可读权限，同时添加一些用户。具体参考《Subversion与版本控制》

编辑Subersion仓库下的conf/senserve.conf文件中的[general]小节，如下：

 

[general]
# anon-access = read
# auth-access = write
password-db = passwd

anon-access = none：表示匿名用户没有任何权限

 

auth-access = write：表示经认证用户拥有读写权限

password-db = passwd：表示存储用户信息的数据位于同级目录下的passwd文件中

编辑conf/passwd文件如下：

 

[users]
admin = admin123
yangdc = yangdc

 这里为仓库配置了三个用户，等号左边是用户名，右边是密码

简单的Subversion仓库用户权限配置

用svn命令提交

svn commit -m "add developers config" --username yangdc --password yangdc

 

 Hudson得到这些更改并触发集成任务之后，相关的Subversion用户信息就已经被Hudson存储起来了，单击Hudson页面左侧的用户，就可看到相关的用户信息。

点击配置，还可添加用户邮箱

 

 

邮件反馈

为Hudson配置邮件服务器信息。系统设置-->E-mail Notification部分

SMTP

Default user e-mail suffix

System Admin E-mail Address

Hudson URL

SMTP Authentication

 

关于SMTP设置，163邮箱的：

收件服务器设置
IMAP收件服务器地址：imap.163.com 安全：开（SSL/TLS） 端口号：993
126邮箱的IMAP服务器地址：imap.126.com ，

yeah邮箱的IMAP服务器地址：imap.yeah.net，其余部分与163一致；
若安全选择关闭，请将端口号改为 143。 

 

 

 发件服务器设置
SMTP发件服务器地址：smtp.163.com 安全：开（SSL/TLS） 端口号：465 / 994
126邮箱的SMTP服务器地址：smtp.126.com ，

yeah邮箱的SMTP服务器地址：smtp.yeah.net；
若安全选择关闭，请将端口号改为 25。 

 

接下来配置Hudson任务使用邮件反馈，进入任务的配置页面，找到最后Post-build Action小节中 E-mail Notification复选框

问题：什么样的构建触发邮件反馈，邮件会发送给谁？

第一个问题：

（1）失败的构建会触发邮件反馈

（2）成功构建后的一次不稳定构建会触发邮件反馈，不稳定往往是由失败的测试引起的，因此成功后的一次不稳定往往表示有回归性测试失败

（3）失败或不稳定构建后的一次成功构建会触发邮件反馈

（4）用户可以配置是否每次不稳定构建都触发邮件反馈

第二个问题：

可以在 Recipients中配置一个邮件列表（用空格分离），一般来说项目负责人应该在这个列表中，选项 Send separate e-mails to individuals who broke the build  表示是否为所有的不稳定构建触发邮件反馈，如果 不选，只有成功构建后的第一次不稳定构建才会触发邮件反馈。推荐选上   

 

Hudson工作目录

 了解Hudson的工作目录不仅能帮助读者理解Hudson用户界面中的各种特性，更重要的是，读者需要明白怎样为Hudson分配合理的磁盘空间，长期运行的持续集成服务往往会消耗大量的磁盘空间，理解哪些任务对应的哪些文件消耗了多少磁盘空间，对持续集成服务的维护来说是至关重要。

 

默认情况：Hudson使用用户目录下的.hudson/目录作为工作目录

改变该目录，设置环境变量HUDSON_HOME,例如，设置为D:\tools\_data\hudson

一个典型的Hudson工作目录：

*.xml

war

users

userContent

updates

plugins

jobs

 

  最重要的就属jobs子目录，

 

 这里包含了所有Hudson的任务配置、每个任务的工作区、构建历史等信息

每个任务都会包含如config.xml、nextBuildNumber、scm-polling.log等文件，其中config.xml包含了该任务的所有配置

每个任务目录下会包含一个workspace子目录，这就是该任务的工作区，这里有最近一次构建所包含的源代码及相关输出

任务目录下有一个builds子目录，该目录包含了所有Hudson记录的历史构建，每个构建对应了一个目录，目录以发生时间命名

 -------------------------------------------------------------------------------------------------------------------------

@author Free Coding http://ln-ydc.iteye.com/ 

http://ln-ydc.iteye.com/admin/blogs/1833031

 

http://ln-ydc.iteye.com/blog/1833031