jenkins自动构建工具使用手册svn+ant+jboss.docx
- 文档编号:9865207
- 上传时间:2023-02-07
- 格式:DOCX
- 页数:15
- 大小:505.04KB
jenkins自动构建工具使用手册svn+ant+jboss.docx
《jenkins自动构建工具使用手册svn+ant+jboss.docx》由会员分享,可在线阅读,更多相关《jenkins自动构建工具使用手册svn+ant+jboss.docx(15页珍藏版)》请在冰豆网上搜索。
jenkins自动构建工具使用手册svn+ant+jboss
jenkins自动构建工具使用手册
1.环境搭建
a).JDK
环境变量的设置:
JAVA_HOME=D:
\ProgramFiles\Java\jdk1.7.0_67\
PATH=%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
CLASSPATH=%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
b).ant
ant的安装与配置
下载地址:
http:
//ant.apache.org/解压后即可使用。
添加系统环境变量:
ANT_HOME=D:
\ProgramFiles\apache-ant;
PATH=%ANT_HOME%\bin;
在cmd中输入ant-version即可查看是否安装成功。
图1.1:
查看ant版本
c)Jenkins
方法一:
在http:
//jenkins-ci.org网站下载war包,然后放倒tomcat的webapp文件夹中,启动tomcat即可。
访问http:
//localhost:
8080即可。
方法二:
在http:
//jenkins-ci.org网站下载war包,在dos下进入相应目录。
输入java-jarjenkins.war即可,在浏览器中输入http:
//localhost:
8080即可。
图1.2:
用命令行启动jenkins
方法三:
下载jenkins安装包,安装jenkins,然后在地址栏输入http:
//localhost:
8080即可。
图1.3:
jenkins搭建成功界面
d)jboss
jboss不用安装,下载后解压到一定目录下即可。
环境搭建阶段遇到的问题即解决办法:
a).修改jenkins的端口的方法:
1).jenkins.war包形式的修改端口的方式,在命令行中输入java-jarjenkins.war--httpPort=8081即可将端口改为8081。
打开浏览器访问http:
//localhost:
8081即可
图1.4:
jenkins修改端口
2).修改安装包形式的jenkins端口的方法:
找到jenkins的安装目录中的jenkins.xml文件E:
/ProgramFiles/Jenkins/jenkins.xml文件,
修改
打开http:
//10.1.1.203:
8081/即可。
b).修改jboss端口的方法:
首先打开jboss7.1.1的配置文件standalond.xml,它在D:
\profession\jboss-as-7.1.1.Final\standalone\configuration路径下。
然后,查找节点
里面有
最后保存成功。
c)jboss下添加管理用户方法:
1).运行--cmd
2). cd E:
/work/jboss-as-7.1.1.Final/bin
3). 输入add-user
4). 按照提示输入用户名和密码
2.添加任务,构建项目
创建job
首先新建一个Job,我们就使用第一项“创建一个自由风格的软件项目”
图2.1:
构建自由风格的项目
点击OK自动跳转到配置界面,我们需要做一下初始化设置,当然这些配置也可以在后期随时修改
配置源码管理工具
在源码管理这里我们选择Subversion(因为我们使用SVN管理代码,如果你使用其他版本管理工具比如Git可以从官网上获得相应的插件)
在RepositoryURL除填入我们的SVN路径 https:
//10.1.1.222:
8443/svn/GreenIts/products/sources/trunk/Test_jenkins
图2.2:
配置svn路径
配置触发器
图2.3:
配置触发器
在其他项目构建完成后才执行构建:
指定的项目完成构建后,触发此项目的构建。
PollSCM:
这是CI系统中常见的选项。
当您选择此选项,您可以指定一个定时作业。
表达式来定义Jenkins每隔多久检查一下您源代码仓库的变化。
如果发现变化,就执行一次构建。
例如,表达式中填写0,15,30,45****将使Jenkins每隔15分钟就检查一次您源码仓库的变化。
Buildperiodically:
此选项仅仅通知Jenkins按指定的频率对项目进行构建,而不管SCM是否有变化。
如果想在这个Job中运行一些测试用例的话,它就很有帮助
ANT构建配置
项目用ant脚本实现的编译和打包,所以选择用InvokeAnt,AntVersion选用自己配置的ant名称,注意不是default那个。
自己的ant是在系统管理---系统设置--ant配置中配置
项目中的ant脚本build.xml
邮件通知设置
添加插件在emailext-template.hpi,token-macro.hpi。
其中token-macro.hpi为支撑插件。
通过系统管理---插件管理--高级---上传方式安装插件。
安装插件
系统管理----系统配置找到JenkinsLocation配置邮件管理员信息
配置邮件管理员信息
系统管理----系统配置找到JenkinsLocation配置邮件管理员信息
ExtendedE-mailNotification
在创建的项目中配置相应的邮件信息
在上图中点击高级设置,配置相应的触发器,其中如果要抄送则形式为,cc:
example@,暗抄送则用bcc:
example@形式。
邮箱触发器配置
此时点击保存--立即构建,即可进行测试。
3.关于邮件设置的全局变量及常用属性的解释
全局变量
1. Override Global Settings:
如果不选,该插件将使用默认的E-mail Notification通知选项。
反之,您可以通过指定不同于( 默认选项)的设置来进行覆盖。
2. Default Content Type:
指定构建后发送邮件内容的类型,有Text和HTML两种.
3. Use List-ID Email Header:
为所有的邮件设置一个List-ID的邮件信头,这样你就可以在邮件客户端使用过滤。
它也能阻止邮件发件人大部分的自动回复(诸如离开办公室、休假等等)。
你可以使用你习惯的任何名称或者ID号,但是他们必须符合如下其中一种格式(真实的ID必须要包含在<和>标记里):
Build Notifications
“Build Notifications”
关于更详细的List-ID说明请参阅RFC-2919.
4. Add 'Precedence:
bulk' Email Header:
设置优先级,更详细说明请参阅RFC-3834.
5. Default Recipients:
自定义默认电子邮件收件人列表。
如果没有被项目配置覆盖,该插件会使用这个列表。
您可以在项目配置使用$ DEFAULT_RECIPIENTS参数包括此默认列表,以及添加新的地址在项目级别。
添加抄送:
cc:
电子邮件地址例如,CC:
someone@
6. Reply To List:
回复列表, A comma separated list of e-mail addresses to use in the Reply-To header of the email. This value will be available as $DEFAULT_REPLYTO in the project configuration.
7. Emergency reroute:
如果这个字段不为空,所有的电子邮件将被单独发送到该地址(或地址列表)。
8. Excluded Committers:
防止邮件被邮件系统认为是垃圾邮件,邮件列表应该没有扩展的账户名(如:
@),并且使用逗号分隔
9. Default Subject:
自定义邮件通知的默认主题名称。
该选项能在邮件的主题字段中替换一些参数,这样你就可以在构建中包含指定的输出信息。
10. Maximum Attachment Size:
邮件最大附件大小。
11. Default Content:
自定义邮件通知的默认内容主体。
该选项能在邮件的内容中替换一些参数,这样你就可以在构建中包含指定的输出信息。
12. Default Pre-send Script:
默认发送前执行的脚本(注:
grooy脚本,这是我在某篇文章上看到的,不一定准确)。
13. Enable Debug Mode:
启用插件的调试模式。
这将增加额外的日志输出,构建日志以及Jenkins的日志。
在调试时是有用的,但不能用于生产。
14. Enable Security:
启用时,会禁用发送脚本的能力,直接进入Jenkins实例。
如果用户试图访问Jenkins管理对象实例,将抛出一个安全异常。
常用属性
∙${FILE,path="PATH"} 包括指定文件(路径)的含量相对于工作空间根目录。
∙path文件路径,注意:
是工作区目录的相对路径。
∙ ${BUILD_NUMBER} 显示当前构建的编号。
∙ ${JOB_DESCRIPTION} 显示项目描述。
∙ ${SVN_REVISION} 显示svn版本号。
还支持Subversion插件出口的SVN_REVISION_n版本。
∙ ${CAUSE} 显示谁、通过什么渠道触发这次构建。
∙ ${CHANGES } -显示上一次构建之后的变化。
∙showPaths 如果为 true,显示提交修改后的地址。
默认false。
∙showDependencies 如果为true,显示项目构建依赖。
默认为false
∙format 遍历提交信息,一个包含%X的字符串,其中%a表示作者,%d表示日期,%m表示消息,%p表示路径,%r表示版本。
注意,并不是所有的版本系统都支持%d和%r。
如果指定showPaths将被忽略。
默认“[%a] %m\\n”。
∙pathFormat 一个包含“%p”的字符串,用来标示怎么打印路径。
∙ ${BUILD_ID}显示当前构建生成的ID。
∙ ${PROJECT_NAME} 显示项目的全名。
(见AbstractProject.getFullDisplayName)
∙ ${PROJECT_DISPLAY_NAME} 显示项目的显示名称。
(见AbstractProject.getDisplayName)
∙ ${SCRIPT} 从一个脚本生成自定义消息内容。
自定义脚本应该放在"$JENKINS_HOME/email-templates"。
当使用自定义脚本时会默认搜索$JENKINS_HOME/email-templatesdirectory目录。
其他的目录将不会被搜索。
∙ script 当其使用的时候,仅仅只有最后一个值会被脚本使用(不能同时使用script和template)。
∙ template常规的simpletemplateengine格式模板。
∙ ${JENKINS_URL} 显示Jenkins服务器的url地址(你可以再系统配置页更改)。
∙ ${BUILD_LOG_MULTILINE_REGEX}按正则表达式匹配并显示构建日志。
∙ regex java.util.regex.Pattern 生成正则表达式匹配的构建日志。
无默认值,可为空。
∙ maxMatches 匹配的最大数量。
如果为0,将匹配所有。
默认为0。
∙ showTruncatedLines 如果为true,包含[...truncated ### lines...]行。
默认为true。
∙ substText 如果非空,就把这部分文字(而不是整行)插入该邮件。
默认为空。
∙escapeHtml 如果为true,格式化HTML。
默认为false。
∙ matchedSegmentHtmlStyle 如果非空,输出HTML。
匹配的行数将变为 html escaped matched line 格式。
默认为空。
∙ ${BUILD_LOG} 显示最终构建日志。
∙ maxLines 日志最多显示的行数,默认250行。
∙ escapeHtml 如果为true,格式化HTML。
默认false。
∙ ${PROJECT_URL} 显示项目的URL地址。
∙ ${BUILD_STATUS} -显示当前构建的状态(失败、成功等等)
∙ ${BUILD_URL} -显示当前构建的URL地址。
∙ ${CHANGES_SINCE_LAST_SUCCESS} -显示上一次成功构建之后的变化。
∙ reverse在顶部标示新近的构建。
默认false。
∙ format遍历构建信息,一个包含%X的字符串,其中%c为所有的改变,%n为构建编号。
默认”Changes for Build #%n\n%c\n”。
∙ showPaths,changesFormat,pathFormat分别定义如${CHANGES}的showPaths、format和pathFormat参数。
∙ ${CHANGES_SINCE_LAST_UNSTABLE} -显示显示上一次不稳固或者成功的构建之后的变化。
∙reverse在顶部标示新近的构建。
默认false。
∙ format遍历构建信息,一个包含%X的字符串,其中%c为所有的改变,%n为构建编号。
默认”Changes for Build #%n\n%c\n”。
∙ showPaths,changesFormat,pathFormat分别定义如${CHANGES}的showPaths、format和pathFormat参数。
∙ ${ENV} –显示一个环境变量。
∙ var– 显示该环境变量的名称。
如果为空,显示所有,默认为空。
∙ ${FAILED_TESTS} -如果有失败的测试,显示这些失败的单元测试信息。
∙ ${JENKINS_URL} -显示Jenkins服务器的地址。
(你能在“系统配置”页改变它)。
∙ ${HUDSON_URL} -不推荐,请使用$JENKINS_URL
∙ ${PROJECT_URL} -显示项目的URL。
∙ ${SVN_REVISION} -显示SVN的版本号。
∙ ${JELLY_SCRIPT} -从一个Jelly脚本模板中自定义消息内容。
有两种模板可供配置:
HTML和TEXT。
你可以在$JENKINS_HOME/email-templates下自定义替换它。
当使用自动义模板时,”template”参数的名称不包含“.jelly”。
∙ template模板名称,默认”html”。
∙ ${TEST_COUNTS} -显示测试的数量。
∙var– 默认“total”。
∙total -所有测试的数量。
∙ fail -失败测试的数量。
∙ skip -跳过测试的数量。
4.遇到的错误及解决办法
jenkins的报错信息
解决办法:
在ant的build.xml中配置
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- jenkins 自动 构建 工具 使用手册 svn ant jboss