window+Jenkins+robotframework单机版简约教程
迫于某人极渴望学自动化测试,因此写下此简约教程.妈蛋我是个JAVA后端开发啊...
此教程为基于window系统的Jenkins单机版,测试代码无版本控制的精要压缩版本教程,勿喷前提:通过
Jenkins
执行自动化测试,本文习惯称为构建,这个名称比较通用.因此,我们将Jenkins执行自动化测试在下文均称为构建
安装Jenkins
如已存在Jenkins
及其的RobotFramework
插件,读者直接跳过
1.安装JAVA环境
百度吧...
2.下载Jenkins
下载地址:https://jenkins.io/zh/download/
如图,选择windows
版本
解压后打开msi
文件,进行安装
选择安装到d:\Jenkins
, 一直点击下一步,就自动安装及启动 Jenkins
服务.
finish
后会浏览器会自动打开localhost:8080
,关闭这个页面
接下来从服务里面看到Jenkins服务
(哈???你说你不会打开看服务???任务栏-鼠标右键-任务管理器-服务
)
3. Jenkins端口配置及插件更新源地址
配置端口
修改端口,防止哪天安装了tomcat 默认8080端口占用了
到安装目录d:\Jenkins\
根目录下找jenkins.xml
文件,修改8080
到其他端口,如9000
,
插件更新源地址
修改此地址为了下载和更新插件更快.到安装目录d:\Jenkins\
根目录下找d:\Jenkins\hudson.model.UpdateCenter.xml
,修改https://updates.jenkins.io/update-center.json
为https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
重启jenkins
服务
再服务管理里面,选中Jenkins
服务,然后右键弹出菜单选重新启动
4. 安装基本插件及账户初始化
重启完毕,浏览器打开localhost:9000
访问Jenkins
,根据提示到D:\Jenkins\secrets\initialAdminPassword
查看密码
选择默认推荐安装
,然后等待安装完毕,安装失败也没关系,跳过待需要时候再安装即可
此时到设置默认管理员账号及密码,以账号root
和密码123456
为例.保存并完成后,填写默认URL
再次保存完成
至此,已完成初始化,接下来开始登陆吧
注意:有可能完成初始化后,打开的页面是空白的而不是欢迎页面,如下
此时通过重启解决
登陆完成后是如下图
5. 安装必要插件
Manage Jenkins
-Manage Plugins
-可选插件
进行搜索安装RobotFramework
插件
等待安装完毕
检查是否已安装,Manage Jenkins-
Manage Plugins-
已安装`检查是否安装成功
安装robotframework环境
如已存在robotframework,读者直接跳过
1. 安装python2最新版
到https://www.python.org/downloads/
,下载最新的2
系列版本最新版
根据实际情况,选择32
或64
位的
如安装Jenkins
一样,安装到D
盘,一路next
即可
将安装目录d:\Python27
及d:\Python27\Scripts
设置到环境变量(具体设置环境变量百度下吧~)
新建
一个cmd
命令符窗口,python -V
检查安装是否成功,注意是2
版本的即可
2. 安装pip
和setuptools
pip
为安装python
第三方库的重要工具,setuptools
是Python distutils
增强版的集合.假如不明白,安装就是了.
配置国内pip源
pip国内的一些镜像
- 阿里云 http://mirrors.aliyun.com/pypi/simple/
- 中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/
- 豆瓣(douban) http://pypi.douban.com/simple/
- 清华大学 https://pypi.tuna.tsinghua.edu.cn/simple/
- 中国科学技术大学 http://pypi.mirrors.ustc.edu.cn/simple/
windows修改源:
在user目录中创建一个pip目录,如: C:UsersAdministratorpip ,在pip
文件夹中 新建文件pip.ini
,内容如下
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
安装最新版pip
pip
命令在安装python2
时候已经安装到d:\Python27\Scripts
,只是版本太旧,我们需要升级到最新版本
C:\Users\oneisall>pip list
DEPRECATION: The default format will switch to columns in the future. You can use --format=(legacy|columns) (or define a format=(legacy|columns) in your pip.conf under the [list] section) to disable this warning.
pip (9.0.3)
setuptools (39.0.1)
You are using pip version 9.0.3, however version 19.2.3 is available.
You should consider upgrading via the 'python -m pip install --upgrade pip' command.
根据提示,我们可以使用python -m pip install --upgrade pip
升级到最新版本19.2.3
C:\Users\oneisall>python -m pip install --upgrade pip
Collecting pip
Downloading https://files.pythonhosted.org/packages/30/db/9e38760b32e3e7f40cce46dd5fb107b8c73840df38f0046d8e6514e675a1/pip-19.2.3-py2.py3-none-any.whl (1.4MB)
100% |████████████████████████████████| 1.4MB 541kB/s
Installing collected packages: pip
Found existing installation: pip 9.0.3
Uninstalling pip-9.0.3:
Successfully uninstalled pip-9.0.3
Successfully installed pip-19.2.3
再次pip list
检测
C:\Users\oneisall>pip list
DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7. More details about Python 2 support in pip, can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-support
Package Version
---------- -------
pip 19.2.3
setuptools 39.0.1
安装最新版setuptools
我们从pip list
中发现setuptools
也已经安装,同理使用python -m pip install --upgrade setuptools
进行升级
C:\Users\oneisall>python -m pip install --upgrade setuptools
DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7. More details about Python 2 support in pip, can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-support
Collecting setuptools
Downloading https://files.pythonhosted.org/packages/b2/86/095d2f7829badc207c893dd4ac767e871f6cd547145df797ea26baea4e2e/setuptools-41.2.0-py2.py3-none-any.whl (576kB)
|████████████████████████████████| 583kB 90kB/s
Installing collected packages: setuptools
Found existing installation: setuptools 39.0.1
Uninstalling setuptools-39.0.1:
Successfully uninstalled setuptools-39.0.1
Successfully installed setuptools-41.2.0
3. 安装重要的几个库
库名称 | 安装命令 |
---|---|
robotframework | pip install robotframework |
wxPython | pip install -U wxPython |
robotframework-ride | pip install robotframework-ride |
selenium2library | pip install robotframework-selenium2library |
archivelibrary | pip install robotframework-archivelibrary |
SSHLibrary | pip install robotframework-SSHLibrary |
ftplibrary | pip install robotframework-ftplibrary |
4. 运行RIDE
安装完,发现没有生成RIDE
桌面图标,可按照下面方法解决:关于RIDE桌面快捷方式创建失败问题解决
桌面右击鼠标,弹出的菜单选择 新建-快捷方式 ,然后在 请键入对象的位置输入这一行命令,d:\Python27\pythonw.exe -c "from robotide import main;main()"
输入路径之后,点击下一步,输入你要建立的快捷方式的名称如
RIDE
换图标:
快捷方式上点击右键-属性-更改图标
,在D:\Python27\Lib\site-packages\robotide\widgets
选取喜欢的图标
双击桌面的图标,即可运行RIDE
5.RIDE运行导入测试用例
文中使用helloword
来测试,如读者本机已有测试用例,则直接跳过此部分
创建用例
桌面新建文件夹test
,在里面新建,__init__.txt
和helloworld.txt
文件
__init__.txt
文件,内容如下:
*** Settings ***
Library Selenium2Library
helloworld.txt
文件,内容如下:
*** Test Cases ***
02
${hi} Set Variable Hello, world!
log ${hi}
导入及运行用例
如图,打开RIDE
后在File-Open Directory
导入文件夹
选中helloworld
用例点击运行进行测试
至此,出现helloworld
即证明用例已经被RIDE
运行,接下来运用robot
命令进行测试
6. 命令行执行测试实例
如读者会相关命令,则直接跳过此部分
新建CMD
命令行窗口,用robot -d report_dir target_dir
执行target_dir
文件夹所有用例,并将报告输出到report_dir
文件夹
如命令行执行桌面的test
文件夹的所有用例,报告输出到桌面的test_report
文件夹:
robot -d C:\Users\oneisall\Desktop\test_report C:\Users\oneisall\Desktop\test
结果如图:
7. 查看报告与指定报告位置
如图所示,有三个报告文件生成,可以用文本编辑器和浏览器分别打开
- log.html
- output.xml
- report.html
创建Jenkins测试任务(JOB)
其实本章最重要的关键部分已经写完了,接下来只是在robotframework
下,将本来在命令行下执行的命令,如何在Jenkins
创建出来而已,个人觉得此章节是最没有挑战性的一部分(貌似整体下来步骤正确应该都没有难度的吧 =_=).只要学会Jenkins
的构建的相关知识即可.如需要详细了解,可以搜索相关文章进行详解.
该章节依赖于Jenkins
正确安装且已经安装必要插件,具体查看安装必要插件章节
该章节依赖于robot
命令可以在命令行中正确执行用例,具体查看命令行执行测试实例章节
1. 创建一个自由风格的项目
打开Jenkins主页,新建一个自由风格的项目
2. 设置参数
根据配置任务参数的页面,Jenkins
的配置可分为以下几个节点
- General
- 源码管理
- 构建触发器
- 构建环境
- 构建
- 构建后触发
根据截图来分析相关要点吧
General
如上图,是General
节点的配置,对于本次教程的宗旨单机+无版本控制+精简+来说,这个节点可以配置的就是两个地方而已
描述
描述项目,将展示在首页
Discard old builds
也就是丢弃旧的构建.明显,每次通过Jenkins
执行完毕自动化测试(习惯称为构建,这个名称比较通用.因此,我们将Jenkins执行自动化测试在下文均称为构建),Jenkins
都会保存每次构建的结果,分析等内容,也占主机的磁盘容量.因此,我们采取丢弃策略,在此我们设置保持构建的最大个数
选项为10
即可
源码管理
此选项是指,执行构建的代码,从哪里来的,一般正常开发是需要代码版本控制的.
由于此教程宗旨为无版本控制的教程,故选取无
构建触发器
也就是什么时候会自动触发构建,本实例就什么都不行,最后到Jenkins
网页来主动触发
构建环境
运行构建的时候,Jenkins
的工作环境,例如一些文件,或者日志选项,具体还是那句话,搜索看具体文档吧,不难
构建
一般来说,构建构建,也就是将项目源码编译成可执行的二进制或虚拟机可运行的包,也成为打包
例如Java
项目,通过maven
或gradle
环境下,使用相关命令将工作空间的代码(版本控制更新的代码),编程成war
或jar
包
由于本教程用途仅仅是执行自动化测试脚本,所以这里指的就是在robotframework
环境下,执行robot target_dir
命令进行自动化测试.
又由于本教程是基于window
系统的用的是window
系统批处理命令,故选Execute Windows batch command
同理,聪明如你,如果是Linux
则选Execute shell
啦
填写命令,复制即可,根据读者你的实际情况,使用相关的绝对路径.否则使用相对路径是从Jenkins工作目录进行执行相关命令,导致找不到文件路程,从而使构建失败
构建后操作
告诉Jenkins
,执行完构建后,要干啥,例如发邮件通知,收集测试结果,构建其他项目,删除工作空间等等
所以,我们以要查看自动化测试报告为例子,故选取Publish RobotFramework test results
主要设置报告输出位置,阈值的大小(测试用例通过率与最终构建状态相关)
点击保存,接下来进行执行构建
3. 执行构建
到我们配置好的TestCase
项目界面,点击Build Now
按钮,即可
点击后自动运行构建(即执行测试命令,进行自动化测试)
4. 查看结果
执行完毕,即可在该次构建结果里面查看各种详情
由于设置输出到报告,不能点击浏览器按钮进行查看,需要到桌面进行查看
5. 检查报告目录
到桌面test_report
目录里面查看报告
浏览器打开查看测试日志报告
6. 指定输出报告目录及通过浏览器浏览报告(生产推荐)
TODO 建议读者探究,有时间再写
总结
滤清流程,涉及的每个工具的用途,基本无障碍进行搭建环境.
考虑到该教程针对的是小白学习,目的是给与小白亲和感,而不是面对一堆工具毫无头绪的这里搞搞哪里搞搞.
教程并不适合生产,所以建议读者在生产环境搭建时,再次深入了解Jenkins
的妙处(分布式+多分支流水线+多环境+项目自动构建发+自动化测试)
参考
RobotFramework环境搭建:https://blog.csdn.net/DaxiaLeeSuper/article/details/77568524
从零搭建Robot Framework+Jenkins持续集成环境:https://www.jianshu.com/p/ef8d3109ac5f
更换pip源到国内镜像:https://blog.csdn.net/chenghuikai/article/details/55258957
本站文章除注明转载/出处外,均为本站原创或翻译,转载前请务必署名
如有版权疑问交流,请给我留言:oneisall8955@gmail.com
本文永久链接:http://liuzhicong.cn/index.php/study/jenkins-robotframe-simple.html