Python：Jenkins包

Python：Jenkins包
文章目录
简介

Jenkins是一个比较方便的一个脚本调度平台工具。

python中封装有Jenkins的API类库，用于处理Jenkins相关的操作。Jenkins对外提供的其实是一堆Restful接口，python-jenkins要做的实际上就是去请求这些接口，并在此基础上做了些包装来保证使用方便。

python中Jenkins包的安装：
```
pip install python-jenkins
1
```
python文件中引入Jenkins：
```
import jenkins
1
```
基于python-Jenkins，我们可以做什么呢？如：
- 创建新的job
- 复制已存在的job
- 删除、更新job
- 获取job的构建信息、版本信息等；
- 运行一个job；
- and many more；
简单看了一下，Jenkins界面上能做的操作，python-Jenkins基本也能干。

接下来，针对几个常用的功能，举几个例子（多数来自于官方示例）介绍下，如何通过python-Jenkins来实现。

功能介绍

 连接Jenkins

如何连接Jenkins，并返回Jenkins的服务器信息。
```
import jenkins

server = jenkins.Jenkins('http://xxx:30030/', username='xx', password='xx')
user = server.get_whoami()
version = server.get_version()
print('Hello %s from Jenkins %s' % (user['fullName'], version))
# Hello xx from Jenkins 2.222.4
1
2
3
4
5
6
7
```
python-jenkins同样支持kerberos登录，这里就不介绍了，有兴趣可以去查看参考文献2里的Example 2。

操作Jenkins的jobs

核心功能，下面例子将展示如何创建、配置和删除Jenkins jobs。

首先需要连接上Jenkins后台，并拿到返回的server对象。

基本功能集锦

先来个基本功能集锦：
```
# 创建job
server.create_job('empty', jenkins.EMPTY_CONFIG_XML)
# 构建无参的job
server.build_job('empty')
# 设置job不可见
server.disable_job('empty')
# 复制job
server.copy_job('empty', 'empty_copy')
# 设置job可见
server.enable_job('empty_copy')
# 重新配置job
server.reconfig_job('empty_copy', jenkins.RECONFIG_XML)
# 删除job
server.delete_job('empty')
# 构建有参的job，比如说指定job有两个参数： 'param1' 和 'param2'
server.build_job('api-test', {'param1': 'test value 1', 'param2': 'test value 2'})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
```
获取当前所有的job列表

获取当前所有的job列表：
```
jobs = server.get_jobs()
1
```
最终返回的是个大list，每个元素是一个dict，含有5个key，即_class、_name、url、color和fullname，举个例子：
```
 {'_class': 'hudson.model.FreeStyleProject', 'name': 'rs_hc_jsc_sc_year', 'url': 'http://xxx:30030/job/rs_hc_jsc_sc_year/', 'color': 'disabled', 'fullname': 'rs_hc_jsc_sc_year'}, {'_class': 'hudson.model.FreeStyleProject', 'name': 'SEV_FIN_HL_INCOME_DAY_VIEW_oss', 'url': 'http://xxx:30030/job/SEV_FIN_HIEW_oss/', 'color': 'blue', 'fullname': 'SEV_FIN_HIEW_oss'},
1
```
其中，'fullname’的value等同于实际job的name。

另外，get_jobs()里实际上有个view_name参数，默认是None，如果指定的话，get_jobs(view_name=xxx)将只返回绑定在视图xxx下的所有jobs。

获取指定job的基本配置

获取已存在的指定job的基本配置：
```
my_job = server.get_job_config('job_name')
print(my_job)		# job configuration (XML format)
1
2
```
返回的XML里，包括了job所有的配置信息，如：
- 参数
- 运行时间
- 依赖的上游任务
- 待运行的脚本任务
- and more
截取xml部分内容，以作展示：
```
<triggers>
    <jenkins.triggers.ReverseBuildTrigger>
      <spec>spec>
      <upstreamProjects>depend_consult_info_a_fileupstreamProjects>
      <threshold>
        <name>SUCCESSname>
        <ordinal>0ordinal>
        <color>BLUEcolor>
        <completeBuild>truecompleteBuild>
      threshold>
    jenkins.triggers.ReverseBuildTrigger>
  triggers>
  <concurrentBuild>falseconcurrentBuild>
  <builders>
    <hudson.tasks.Shell>
      <command>sh /home/bin/run-task.sh dws/consult_info ${time_hour}command>
    hudson.tasks.Shell>
  builders>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
```
需要注意，根据job创建时依赖的模板不同，不同类型job在这里返回的xml也是不同的。并不是说，针对所有job，我只要解析出hudson.tasks.Shell节点下的内容，就能知道这个job是干嘛的，因为有的不同类型的job，可能并没有hudson.tasks.Shell节点。

获取指定job的信息字典

拿到job的信息字典：
```
infors = server.get_job_info('job_name')
print(infors)
1
2
```
字典含有以下key：
- ‘_class’：应该是job依赖的模板类型；
- ‘actions’：似乎是job的参数
- ‘description’：job的描述
- ‘displayName’
- ‘displayNameOrNull’：暂时不明
- ‘fullDisplayName’：
- ‘fullName’：job的全name
- ‘name’：job的name
- ‘url’：job的url地址；
- ‘buildable’：暂时不明，如：'buildable': True,
- ‘builds’：dict-list，存储了一堆构建记录的dict；
- ‘color’：暂时不明
- ‘firstBuild’：暂时不明
- ‘healthReport’：暂时不明
- ‘inQueue’：暂时不明，如'inQueue': False
- ‘keepDependencies’：暂时不明，如'keepDependencies': False
- ‘lastBuild’：最近一次构建的构建记录，如下；
- ‘lastCompletedBuild’：最近一次已完成？？构建的构建记录，如下；
- ‘lastFailedBuild’：最近一次失败构建的构建记录，如下；
- ‘lastStableBuild’：最近一次稳定构建的构建记录，如下；
- ‘lastSuccessfulBuild’：最近一次成功构建的构建记录，如下；
- ‘lastUnstableBuild’：最近一次不稳定构建的构建记录，如下；
- ‘lastUnsuccessfulBuild’：最近一次不成功构建的构建记录，如：
```
'lastUnsuccessfulBuild': {'_class': 'hudson.model.FreeStyleBuild', 'number': 131, 'url': 'http://xxx:30030/job/dws_consult_info/131/'}
1
```
- ‘nextBuildNumber’：下次构建的序号（指代第多少次构建），如：'nextBuildNumber': 145
- ‘property’：job依赖的参数，如：
```
'property': [{'_class': 'hudson.model.ParametersDefinitionProperty', 'parameterDefinitions': [{'_class': 'me.leejay.jenkins.dateparameter.DateParameterDefinition', 'defaultParameterValue': {'_class': 'me.leejay.jenkins.dateparameter.DateParameterValue', 'name': 'time_hour', 'value': '20230910'}, 'description': '当前日期的前一天', 'name': 'time_hour', 'type': 'DateParameterDefinition'}]}, {'_class': 'com.xxx.jenkins.ChargerJobProperty'}]
1
```
- ‘queueItem’：暂时不明
- ‘concurrentBuild’：暂时不明，如'concurrentBuild': False
- ‘disabled’：该job是否不可见，如'disabled': False
- ‘downstreamProjects’：dict-list，即与其直连的下游任务
- ‘labelExpression’：暂时不明
- ‘scm’：暂时不明
- ‘upstreamProjects’：dict-list，依赖的上游任务，举例：
```
'upstreamProjects': [{'_class': 'hudson.model.FreeStyleProject', 'name': 'depend_consult_info_a_file', 'url': 'http://xxx:3333/job/depend_consult_info_a_file/', 'color': 'blue'}]
1
```
以上，想获取什么信息就可以去取，比如我现在想获取一个job上次完成构建的构建序号：
```
last_build_number = server.get_job_info('api-test')['lastCompletedBuild']['number']
1
```
获取执行构建记录的完整信息

拿到指定构建记录的完整信息：

如：
```
last_build_number = server.get_job_info('api-test')['lastCompletedBuild']['number']
build_info = server.get_build_info('api-test', last_build_number)
print(build_info)
1
2
3
```
输出举个例子，如：
```
{
	'_class': 'hudson.model.FreeStyleBuild',
	'actions': [{
		'_class': 'hudson.model.CauseAction',
		'causes': [{
			'_class': 'hudson.model.Cause$UpstreamCause',
			'shortDescription': 'Started by upstream project "depend_consult_info_a_file" build number 126',
			'upstreamBuild': 126,
			'upstreamProject': 'depend_consult_info_a_file',
			'upstreamUrl': 'job/depend_consult_info_a_file/'
		}]
	}, {
		'_class': 'hudson.model.ParametersAction',
		'parameters': [{
			'_class': 'me.leejay.jenkins.dateparameter.DateParameterValue',
			'name': 'time_hour',
			'value': '20230907'
		}]
	}, {}],
	'artifacts': [],
	'building': False,
	'description': None,
	'displayName': '#20230907-Timer Trigger',
	'duration': 1006379,
	'estimatedDuration': 1050847,
	'executor': None,
	'fullDisplayName': 'dws_consult_info #20230907-Timer Trigger',
	'id': '141',
	'keepLog': False,
	'number': 141,
	'queueId': 625157,
	'result': 'SUCCESS',
	'timestamp': 1694128120063,
	'url': 'http://xxx:30030/job/dws_consult_info/141/',
	'builtOn': '',
	'changeSet': {
		'_class': 'hudson.scm.EmptyChangeLogSet',
		'items': [],
		'kind': None
	},
	'culprits': []
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
```
以上，如果想获取到以上构建记录里，参数time_hour的值，就可以层层解剖，使用以下代码：
```
build_info = server.get_build_info(job_name, last_build_number)
print(build_info['actions']['parameters'][0]['value'])
1
2
```
当前是否处于构建中：is_building=build_info['building']

指定构建的成功与否：build_result = build_info['result']

参考文献
1. Python-Jenkins 如何操作 Job/View模块
2. Python Jenkins官方文档(英文)
3. Python Jenkins包的官网
4. 基于Python的Jenkins的二次开发对python-Jenkins的原理做了简单介绍
5. Jenkins使用入门
相关阅读:
使用 Python 进行测试（6）Fake it...
面试官：请求转发和请求重定向有什么区别？
机器学习笔记之变分推断(五)重参数化技巧
 车载以太网物理层SerDes
mysql中使用聚合函数结果集为空，仍显示size为1，所有元素为Null问题的解决
 java计算机毕业设计菲特尼斯健身管理系统设计与实现MyBatis+系统+LW文档+源码+调试部署
 LidarView工程搭建指南
 工作比读研简单多了
 帧内预测中的initPredIntraParams()函数 (负参考方向处在跑代码时再看一遍）
git仓删除当前仓且保留嵌套子仓--类似保留特定文件目录
原文地址：https://blog.csdn.net/wlh2220133699/article/details/132813969

文章目录

简介

功能介绍

连接Jenkins

操作Jenkins的jobs

基本功能集锦

获取当前所有的job列表

获取指定job的基本配置

获取指定job的信息字典

获取执行构建记录的完整信息

参考文献