Jenkins操作手册
1、持续集成(CI) Continuous integration 持续集成 团队开发成员每天都有集成他们的工作,通过每个成员每天至少集成一次,也就意味着一天有可 能多次集成。在工作中我们引入持续集成,通过持续集成自动构建(代码的编译、发布、部署、 用例的更新和自动化执行),从而达到尽早发现代码集成的错误。
2、在没有持续集成时,开发的模式是:
第一步:项目一开始划分模块,将模块分配给对应的开发
第二步:开发对自己所负责的模块进行开发以及对应后期的单元测试
第三步:等所有模块开发完成后,由项目老大(开发负责人)对所有模块的代码进行集成
第四步:将集成好的代码部署到环境上,交由测试人员进行集成测试
第五步:测试过程中发现bug,测试人员提交bug并进行记录
第六步:对应的开发人员进行bug修复
第七步:等所有开发人员将bug修复好,再进行代码集成,交给测试进行回归测试 这样我们会陷入一个循环:修改bug集成代码部署测试的循环中
缺陷: a.bug永远都是在最后才发现,不能及时发现。 b.这样的话测试效率低,使得交付效率质量差。
3、用Jenkins做持续集成的目的:及时发现bug,提高效率
4、持续集成的优点:
1、统一的代码库
2、自动部署和构建
3、自动测试
4、保证项目的交付质量
5、用什么实现持续集成? 使用Jenkins工具能帮我们实现持续集成
6、什么是Jenkins?
是基于Java开发的一种持续集成工具,用于监控持续重复的工作,旨在提供一个开放易用的
软件平台,使软件的持续集成变成可能。
7、Jenkins有哪些功能 1)持续的软件版本发布/测试项目。
2)监控外部调用执行的工作。 Jenkins拥有的特性包括:
1)易于安装只要把jenkins.war部署到servlet容器,不需要数据库支持。
2)易于配置所有配置都是通过其提供的web界面实现。
3)集成RSS/Email通过RSS发布构建结果或当构建完成时通过email通知。
4)生成JUnit/TestNG测试报告。
5)分布式构建支持Jenkins能够让多台计算机一起构建/测试。
6)文件识别:Jenkins能够跟踪哪次构建生成哪些jar,哪次构建使用哪个版本的jar等。
7)插件支持:支持扩展插件,你可以开发适合自己团队使用的工具。 Jenkins的主要目标是监控软件开发流程,快速显示问题。所以能保证开发人员以及相关人员
省时省力提高开发效率。
8、Jenkins中的节点? 一个节点是一个代理服务器。建议使用字母、数字或字母和数字的组合。最好见名知意。不建议 使用标点符号和中文(中文命名没有问题,但Job中无法引用)
Jenkins环境搭建
一、需要的应用软件如下:
JDK1.8 最好安装1.8的
Jenkins.war包
二、安装JDK (jdk8u60windowsx64.exe) 把JDK放入G盘,双击jdk8u60windowsx64,安装路径放入为G:\java(默认路径) 设置环境变量:在桌面进入计算机右键点击属性高级系统配置环境变量点击新建(新建之前把 环境变量里面之前的JAVA_HOME,CLASSPATH全部删掉,假如没有的话就新建)
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019154128350-1800340015.png)
(1)新建>变量名"JAVA_HOME",变量值:G:\java(具体看自己的java安装的路径)
(2)编辑>变量名"Path",在原变量值的最后面加
上:;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin (3)新建>变量名"CLASSPATH",变量
值:.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar(注 意冒号前面有个"."一定要加上)
2,验证变量设置的正确性,win+r,输入java,javac 出现如下图:JDK安装成功;
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019154350241-1700226277.png)
三、linux环境上搭建jenkins 第一步:把本地jenkins.war包存放到tomcat路径下apachetomcat7.0.56/webapps
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019163726896-1067720795.png)
第二步:启动tomcat,启动后jenkins.war包会自动解压,生成一个jenkins目录
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019163736664-1902603929.png)
第三步:浏览器地址栏中输入IP地址+8080端 口/jenkins(http://192.168.23.129:8080/jenkins),正常打开jenkins应用页面 如果页面报错要关闭防火墙:service iptables stop
页面显示如下:
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019163816799-717190046.png)
这段话翻译过后大概的意思就是:
Jenkins管理员密码已经写入服务器/root/.jenkins/secrets/initialAdminPassword 文件中, 复制密码粘贴到下面的文本框中。
讲解下:/root 路径就是 cd ~
第四步:在linux环境中输入命令: cat /root/.jenkins/secrets/initialAdminPassword ,复 制密码 到文本框中,点击continue
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019163902523-501612185.png)
以上是登录密码;
第五步:点击安装建议性插件
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019163912199-45445755.png)
左边 建议安装 ,右边 自定义安装
接下来会安装所有建议性插件,这个安装时间有些长,请耐心等待
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019163921539-170221139.png)
第六步:输入以后登录jenkins的用户名,密码>然后点击保存并完成
最后,当你看到这个页面,说明jenkins已经安装好了
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019163958828-1992161571.png)
如果界面显示英文可以翻译为中文:谷歌浏览器右上角点击如下图标志 选择翻译
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164020239-1730602755.png)
第七步:Jenkins修改密码
1.点击页面右上角用户名
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019173015883-1313787413.png)
2.点击设置
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019174202297-552520362.png)
3.修改密码,点击应用,保存。
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164042741-6120463.png)
4.重启jenkins
在浏览器地址中输入:http://192.168.153.131:8080/jenkins/restart 地址以自己的IP地 址为准
(添加restart)jenkins重启
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164052385-1902281204.png)
重启后,可以用新密码登录。
第八步:如果出现其他异常需要重新安装jenkins环境的步骤如下:(如果Jenkins启动正常请忽 略以下操作)
第一步:rm rf /root/.jenkins 清空所有数据
第二步:webapps中删除Jenkins目录 重启tomcat
第三步:一切按照上面的步骤操作
注意点:依赖包出错不用管
四、jenkins添加节点 第一步:首页点击系统管理——》管理节点——》新建节点
(注意点:(先设置全局安全配置))
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164114762-1912501664.png)
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019174643256-488670751.png)
第二步:输入节点名称,勾选固定代理
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164146724-1132011728.png)
第三步:输入节点的具体信息,这里需要注意的是启动方法,启动方法没有java web请往下看
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164152852-211713849.png)
名字:唯一标识一个代理,通常使用代理主机名
描述:代理的cpu内核,内存使用情况描述。 执行者数量:控制并发构建数量 远程工作目录:一个代理有一个专门的jenkins目录
标签:对多节点分组,代理标签,工程标签相同,说明这个工程在这个代理上运行。 用法:默认选择尽可能使用这个节点
启动方法:默认选择通过java web启动代理 (全局安全中设置)
注意点:(先设置全局安全配置)
在选择启动方法中,如果没有java web 启动代理选项,那么就需要进行如下配置 第一步:点击系统管理,选择全局安全配置
第二步:勾选启用安全
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164202321-1582379049.png)
第三步:代理中选额随机选取,代理协议都进行勾选
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164215396-676749323.png)
第四步:选择应用,保存>然后点击test_vm
jar包就是代码 类和工具函数
注意:( 将agent 放到d:jenkens下)
出现如下的信息:说明代理服务器没有连接jenkins
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164226957-466852956.png)
节点可以理解为一个代理,一台服务器。Jenkins是一个ci(持续集成)平台,每个代理 服务器要与jenkins进行集成,需要执行java jar ,后面是代理服务器Ip地址,通过这条 命令,执行成功说明代理已集成在ci平台
将代理连接jenkins方法: 从代理命令行运行
第一步:下载agent.jar文件 ,保存在本地G:\jenkins 第二步:在dos中G:\jenkins目录下执行命令
java jar agent.jar jnlpUrl http://192.168.23.129:8080/jenkins/computer/test_vm/slaveagent.jnlp secret 50027f0935559679aeb8ba30adca6e16fed937199e37a95c352984235a3400be workDir "G:\jenkins"
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164244115-1983122720.png)
注意:把以上的复制到dos下执行
这里需要注意的是:根据自己的jenkins页面内容copy,再执行
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164251402-1972900291.png)
执行之后,看到Agent discovery successful 和connected 说明代理连接jenkins成功
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164328648-1309896074.png)
成功jenkins首页显示,代理电脑右下方红色叉叉消失,并且显示代理服务器详细信息
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164335374-1958985282.png)
五、Jenkins构建项目:
第一步:首页,点击开始创建一个新任务输入一个项目名称,选择构建一个自由风格的软件项 目,最后确定
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164342491-2133405431.png)
第二步:输入项目具体配置
1. 项目名称:自定义
2. 限制可以运行该项目的位置:输入标签,标签为代理的标签(指定项目在哪个代理机上执行)
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164350080-1490487855.png)
或者
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019183939699-442735829.png)
3.构建:点击增加构建步骤 ,选择执行windows批处理命令
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164355434-348325565.png)
4. 命令输入,例如执行单个用例
Pybot test 用例名称+套件路径
Pybot test 正常登录 G:\Python271\discuz论坛\dcs\论坛项目.txt
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164411197-1126598083.png)
批处理命令还有
执行所有项目中的用例:pybot 项目路径 执行当个套件中的用例:pybot 套件路径 执行单个用例:pybot test 用例名称 套件地址 执行标签用例:pybot i 标签名称 套件地址
5.点击保存>然后点击立即构建>构建完成之后点击#2>点击控制台输出就可以看到相关的 日志了
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164421115-1559162418.png)
复制报告地址在浏览器输入: G:\jenkins\workspace\auto_test\report.html
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164440154-912848195.png)
6.如果出现下面的错误(没有没有出现就忽略):
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164446864-1873794303.png)
那么就给项目添加一个工作空间,如果系统自动选择工作空间是master,那么就进行修改
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164457463-1603919506.png)
也可以使用自己自定义的工作空间,就是工作空间与代理服务器工作空间不同的时候
可以自定义工作空间
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164502807-1686463535.png)
如果出现如下报错:
hudson.AbortException: No files found in path G:\jenkins\output\auto_test with configured filemask: output.xml 就需要把工作空间和日志输出路径都改为G:\jenkins就可以了。
7.构建触发器(设置定时任务) Build periodically 在日程表中设置
触发器是用于控制自动化测试执行时间的 日程表里有5个数字,分别为:
H * * * * 分钟:059 小时:023 日:131 月:112
周:07 0和7都代表星期天
例如: 每15分钟执行一次 H/15 * * * * (注意:要空一格,H/1 一小时,H/2-15 15分钟 )
每天8点16点,每1小时执行一次
H 816/1 * * *
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164515473-423486566.png)
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164531788-1549828866.png)
8.添加插件,以及插件的使用
robot framework plugin
Email extension template
Email ext recipients column
第一步:在首页,选择系统管理,管理插件,在过滤中输入插件名称
1. robot framework plugin
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164550721-490707357.png)
2. Email extension template
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164611753-776491259.png)
3. Email ext recipients column plugin
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164617825-745664126.png)
安装后如下
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164623839-8348117.png)
如果出现插件无法下载的情况,可以进行如下设置:
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164630914-624539063.png)
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164640964-532007347.png)
9.Robot framework plugin作用:通过图表查看自动化测试结果 Robot framework plugin使用 第一步:选择一个工程,点击配置
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164656845-906410101.png)
第二步:在构建构建后操作中点击 publish robot framework results
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164702387-217880856.png)
第三步:输入路径,此路径为批处理命令执行后生成xml,html后的路径(工作空间中的路径) G:\jenkins\workspace\auto_test
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164721904-1968719125.png)
第四步:添加后的结果
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164732347-939872224.png)
第五步:robot framework plugin 插件作用,主要是能显示robot results,pass or Fail 以及 统计执行成功失败的比例 在安装frameworkplugin后不能选择到插件,就需要重启tomcat,或者重启jenkins 再不行就 安装一个zentimestamp.plugin
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164741982-1867654436.png)
六、Jenkins设置邮件通知: 安装插件
Email Ext Recipients Column Plugin 电子邮件收件人列插件
Email Extension Plugin 电子邮件扩展插件
Email Extension Template Plugin 电子邮件扩展模板插件
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164754927-1957173065.png)
第一步:在首页点击系统管理>点击系统设置>找到Jenkins Location
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164759949-1591633669.png)
第二步:这里电子邮件通知,需要设置的参数如下
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164805185-2121860172.png)
第三步:增加构建后操作步骤,选择email notification
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164823100-506941682.png)
第四步:收件人:输入收件人邮箱,在构建失败后,会发送邮件通知
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164828824-1060555514.png)
第五步:选择可编辑的电子邮件通知,可以替换邮件的主题和内容
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164833353-894132943.png)
第六步:点击高级设置
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164854655-179596427.png)
第七步: 点击右下角的高级设置选择添加触发器,选择总是
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019164900684-251584015.png)
第八步:最后收到邮件,说明你的邮件通知设置成功!
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165315507-267536685.png)
第九步:设置Jenkins的时间和电脑同步
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165322004-1342351328.png)
打开 【系统管理】>【脚本命令行】运行下面的命令:
System.setProperty('org.apache.commons.jelly.tags.fmt.timeZone', 'Asia/Shanghai')
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165332934-1459298591.png)
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165344488-312408622.png)
七、Jenkins+svn实现拉取最新的代码或脚本跑定时任务:
1、打开配置、找到subversion、Local module directory里面有个点"."需要删除:
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165351870-1433822544.png)
2、添加凭据:
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165402779-1819683881.png)
3、把要被运行的脚本文件放入上传到svn:
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165408519-1359258623.png)
4、然后再构建输入:Pybot test test2 G:\jenkins\auto\论坛项目.txt
也可以设置定位任务上面过程有讲到
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165414843-1732305162.png)
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165431472-1588136462.png)
5、点击构建
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165438227-378731141.png)
6、点击构建后Jenkins会自动拉取SVN服务器的代码到Jenkins的工作空间然后通过执行 Windows批处理命令就可以执行从 SVN拉取下来的最新的代码,这样就可以实时跑服务器中最新的代码或者自动化测试用例。
![](https://img2020.cnblogs.com/blog/2012893/202010/2012893-20201019165452413-1251247452.png)