基于Python的Jenkins的二次开发操作


Posted in Python onMay 12, 2020

背景

最近我们在整一个云执行的平台,底层用的是Jenkins来做执行引擎,方便的把我们的脚本做一个统一的调度。

Jenkins确实是一个非常方便的框架,它提供了一整套的RESTful的API,可以非常方便的做二次开发,而且提供了一个python的库,操作起来就更加方便了。

常用的Jenkins概念

我们在使用Jenkins的时候,一般看到的都是Jenkins的View。

也就是说我们看到的基本上都是一些视图。

每一个构建的内容,无论是执行用例,跑脚本,还是打包编译发布,都是一个job。

每一个job都有一个对应的name,如果这个job被放在某个文件夹了,那么name就是文件夹名+job名。在查看job信息的时候,会返回一个full_name字段,指的就是这个了。

PythonSDK

pip install python-jenkins执行这条命令就可以安装SDK了。

官网:https://pypi.org/project/python-jenkins/

说明文档:http://python-jenkins.readthedocs.io/en/latest/

说明文档都是英文的,如果有兴趣,看这块当然最好,不过这个SDK实际上非常非常的简单,如果直接去看源代码,也是没问题的,我在开发的过程中,基本上都是去看源码来写的,SDK里面函数命名比较直白,不用深刻理解也能够正常的去使用。

这里列一些比较常用的方法,也是我这次开发的时候用到的一些,我按照我自己写的过程中,一步一步的写出来。

开发过程

job信息查询

在Jenkins中,每一个构建都是一个job,所以,我们做开发的时候,要在页面上展示历史的构建信息,因此,要能够拿到历史执行job的信息。因此我们要使用get_job_info这个方法。

def get_job_info(self, name, depth=0, fetch_all_builds=False):
 '''Get job information dictionary.

 :param name: Job name, ``str``
 :param depth: JSON depth, ``int``
 :param fetch_all_builds: If true, all builds will be retrieved
     from Jenkins. Otherwise, Jenkins will
     only return the most recent 100
     builds. This comes at the expense of
     an additional API call which may
     return significant amounts of
     data. ``bool``
 :returns: dictionary of job information
 '''

这里的name参数指的是job的名字,比如我新建了一个叫自动化测试这么个job,那么这个name传的就是自动化测试,如果我把这个job放到了某个文件夹中,那么name这个参数需要传文件夹名/自动化测试。

这里有一个坑,在Python2.7版本中传递这个name,如果以变量的形式传递过去,会有一个报错,规避的方法是name.encode('utf-8')做一下编码的处理。返回的参数是这些:

在builds字段里面就存有所有的历史构建数据。在property这个字段中放有Jenkins构建时的各种参数。

构建日志

拿到了构建数据,我们需要在页面上展示出来,如果能在页面上直接看日志就更方便了,因此要把每次的构建日志拿出来,需要调用get_build_console_output这个方法。

def get_build_console_output(self, name, number):
 '''Get build console text.

 :param name: Job name, ``str``
 :param number: Build number, ``int``
 :returns: Build console output, ``str``
 '''

这里可以拿到Jenkins的构建日志,返回的就是一个字符串了。需要注意的是,如果你想要构建的时候也展示构建日志,只需要在构建的时候调用这个方法就行,会返回调用时候构建的日志,用socket或者轮询的方式都可以实现实时日志的展示。

执行构建

执行构建当然是非常关键的一步,我们可以使用build_job这个方法来执行构建。

def build_job(self, name, parameters=None, token=None):
 '''Trigger build job.

 This method returns a queue item number that you can pass to
 :meth:`Jenkins.get_queue_item`. Note that this queue number is only
 valid for about five minutes after the job completes, so you should
 get/poll the queue information as soon as possible to determine the
 job's URL.

 :param name: name of job
 :param parameters: parameters for job, or ``None``, ``dict``
 :param token: Jenkins API token
 :returns: ``int`` queue item
 '''

这里的name参数跟job信息查询的参数一样,也会有编码的问题。parameters字段传入的是一个字典类型,也就是在页面上点击构建的时候,需要填入的参数。token参数在Jenkins这个类初始化的时候就已经有了,所以一般来说无需传入。这个方法会返回一个queue_item的编号,这个就是Jenkins的构建编号,这个编号可以做一些其他数据的查询,比如构建状态,取消构建等操作,在SDK里面都有对应的方法。

注意:绝对不行用这个来查询是否处于构建中,这个编号在一定时间内会出现失效的情况,如果构建时间过长,会导致查询不到结果而报错,实际上job依然处于构建中

这些方法使用起来比较方便,但是有一些局限性,我们如果在构建的时候用了第三方插件,这些方法是没办法拿到第三方插件的结果的,比如我们这里用RobotFramework的插件来处理了结果,用这些方法是没办法拿到结果的。

从原理入手

Jenkins对外提供的是一个RESTful的接口,那么Python的SDK做的动作实际上就是去请求这个接口,只不过做了一些包装,保证了易用性,很多方法的核心,都会用到jenkins_request,比如:

response = self.jenkins_request(requests.Request(
'POST', self.build_job_url(name, parameters, token)))

有兴趣的可以自己去读一读源码,整个SDK实际上就是基于requests这个库做了一下包装,然后最终都是通过jenkins_request去请求RESTful的API。我们进入jenkins的页面,在右下角能看到一个这样的东西。

有这个标记的页面,就是有接口的,那么这个接口是怎么拿的呢?

从源码里面可以找到答案,很多方法里面都有这么样一个东西。

self.jenkins_open(requests.Request('GET', self._build_url(INFO),auth=auth),
   add_crumb=False, resolve_auth=False)

response = self.jenkins_open(requests.Request('GET', self._build_url(BUILD_INFO,locals())))

在最上方的配置中可以找到:

INFO = 'api/json'

也就是说,在我们看到页面的后方加上/api/json就可以拿到数据了。

所有的操作都在这个数据的背后了,也就是说只要写好这个url的拼接规则,就能很简单的去做二次开发了。

当然,在开发的过程中,也是有很多坑的,比如拿历史数据的时候,接口竟然不返回历史构建的状态。。。。

总结

整个开发过程下来还算比较顺利,由于源码比较简单的原因,基本上遇到问题都能通过看源码来解决,但是比较大的问题就是返回结果的枚举没有一个地方列出来,所以导致开发完成后经常有地方需要修修补补。

以上这篇基于Python的Jenkins的二次开发操作就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持三水点靠木。

Python 相关文章推荐
Python双精度浮点数运算并分行显示操作示例
Jul 21 Python
python中列表和元组的区别
Dec 18 Python
Python实现识别手写数字 Python图片读入与处理
Mar 23 Python
使用DataFrame删除行和列的实例讲解
Apr 08 Python
pandas 条件搜索返回列表的方法
Oct 30 Python
Python中对数组集进行按行打乱shuffle的方法
Nov 08 Python
python中的colorlog库使用详解
Jul 05 Python
python实现自动化报表功能(Oracle/plsql/Excel/多线程)
Dec 02 Python
python小白学习包管理器pip安装
Jun 09 Python
python中导入 train_test_split提示错误的解决
Jun 19 Python
Python用dilb提取照片上人脸的示例
Oct 26 Python
Python就将所有的英文单词首字母变成大写
Feb 12 Python
Python-jenkins模块获取jobs的执行状态操作
May 12 #Python
Python-jenkins 获取job构建信息方式
May 12 #Python
python进行参数传递的方法
May 12 #Python
python输出数学符号实例
May 11 #Python
使用matlab 判断两个矩阵是否相等的实例
May 11 #Python
Django models文件模型变更错误解决
May 11 #Python
对Matlab中共轭、转置和共轭装置的区别说明
May 11 #Python
You might like
PHP Session变量不能传送到下一页的解决方法
2009/11/27 PHP
php实现数组按指定KEY排序的方法
2015/03/30 PHP
PHP将字符串首字母大小写转换的实例
2017/01/21 PHP
javascript 隐藏/显示指定的区域附HTML元素【legend】用法
2010/03/05 Javascript
自写简单JS判断是否已经弹出页面
2010/10/20 Javascript
理解JavaScript中的对象 推荐
2011/01/09 Javascript
Ext.get() 和 Ext.query()组合使用实现最灵活的取元素方式
2011/09/26 Javascript
jquery submit ie6下失效的原因分析及解决方法
2013/11/15 Javascript
jQuery实现的多屏图像图层切换效果实例
2015/05/07 Javascript
javascript实现在线客服效果
2015/07/15 Javascript
js实现仿Discuz文本框弹出层效果
2015/08/13 Javascript
JavaScript简单下拉菜单实例代码
2015/09/07 Javascript
微信小程序-拍照或选择图片并上传文件
2017/01/06 Javascript
node中使用es5/6以及支持性与性能对比
2017/08/11 Javascript
微信小程序三级联动选择器使用方法
2020/05/19 Javascript
vue 下列表侧滑操作实例代码详解
2018/07/24 Javascript
ng-events类似ionic中Events的angular全局事件
2018/09/05 Javascript
[02:28]PWL开团时刻DAY3——Ink Ice与DeMonsTer之间的勾心斗角
2020/11/03 DOTA
python遍历文件夹并删除特定格式文件的示例
2014/03/05 Python
python调用机器喇叭发出蜂鸣声(Beep)的方法
2015/03/23 Python
利用PyInstaller将python程序.py转为.exe的方法详解
2017/05/03 Python
python实现将读入的多维list转为一维list的方法
2018/06/28 Python
Python get获取页面cookie代码实例
2018/09/12 Python
python学生管理系统
2019/01/30 Python
Django命名URL和反向解析URL实现解析
2019/08/09 Python
Python matplotlib生成图片背景透明的示例代码
2019/08/30 Python
numpy 声明空数组详解
2019/12/05 Python
如何用python处理excel表格
2020/06/09 Python
Speedo速比涛中国官方网站:全球领先泳装运动品牌
2018/04/24 全球购物
新娘父亲婚礼致辞
2014/01/16 职场文书
旷课检讨书3000字
2014/02/04 职场文书
党员干部三严三实心得体会
2014/10/13 职场文书
群众路线教育实践活动实施方案
2014/10/31 职场文书
2014年评职称工作总结
2014/11/20 职场文书
2014年乡镇民政工作总结
2014/12/02 职场文书
springboot用户数据修改的详细实现
2022/04/06 Java/Android