Jenkins REST API 实例
背景:
Jenkins具有丰富的插件生态,足以满足我们日常工作的需求,但如果我们想通过具体的Jenkins任务直接对外提供服务,而不想将内部的具体实现对外暴露(否则,需添加对应的用户权限,通过页面执行job);可以对外直接提供接口,第三方直接调用接口(比如提供给开发,提测前回归冒烟用例集),执行相应的Jenkins任务并获取任务结果
Jenkins本身支持丰富的API接口,我们通过调用接口,基本可以实现所有需要的功能,包括获取JOB,触发JOB执行,甚至删除JOB等
Jenkins的Remote API以REST-like
的形式进行提供,通过对特定的API执行POST请求即可
站点说明:
如果搭建的Jenkins站点为 http://192.168.6.224:8080
其中创建了一个job,job name为"pythontest",还配置了一个字符参数test,job只是执行一个简单的python script
之后所有模拟的请求,都通过postman工具进行
REST API:
站点所有支持的API都可以通过地址http://
192.168.6.224:8080/api 获取,如图
某一个job的所有相关API,可以通过地址 http://192.168.6.224:8080/job/{jobname}/api/来获取
如我们的job name是pythontest,则地址是 http://192.168.6.224:8080/job/pythontest/api/
所有支持的API如图
JOB API---获取JOB相关信息:
我们通过url直接获取job的相关信息,生成xml格式或者JSON,甚至可以用python、ruby脚本获取
如获取job(pythontest)的信息,要获取json的地址
http://192.168.6.224:8080/job/pythontest/api/json?pretty=true
可以获取name,build等的所有信息,后面说明都使用json格式
XML的地址 http://192.168.6.224:8080/job/pythontest/api/xml
python http://192.168.6.224:8080/job/pythontest/api/python?pretty=true
JOB API---获取Build相关信息:刚才我们获取的是job所有的相关信息,可能我们还需要获取某一次build的信息如果我们要获得这个pythontest第一次build的信息
JOB API--信息过滤:
之前获取的所有相关信息,可以通过添加参数tree=XXX[],来过滤出你所感兴趣的节点,类似于正则表达式
详细的可以参考,之前站点API 说明中的"Controlling the amount of data you fetch"这一节
如何用,假设通过 http://192.168.6.224:8080/job/pythontest/api/json?pretty=true 会获取所有的信息
那么添加 tree=builds[*] 可以获取所有builds下的节点
地址拼接为 ,直接http get请求
http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds[*]
通过地址 http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds[displayName]
可以获取builds下,所有displayName的节点,其中一共有三个displayName
如果要获取三个displayName节点中第二个节点,可以通过{X,Y}
http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds[displayName]{1,2}
如果要获取两个相关的节点,通过,连接两个过滤节点
http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds[*],url[*]
这样就可以获取build和url的信息
JOB API--执行Build:
1 直接执行,不包括参数
此时暂时删除pytest的参数,使它可以直接执行
那么执行build的API地址就是
http://192.168.6.224:8080/job/pythontest/build
请求方法为POST,通过post man发送这个请求
会发现请求失败,返回"Authentication required"
此提示信息说明执行job的时候需要身份认证,可以通过postman的"Authorization",选择“Basic Auth”, 再输入登录jeknins,可以有权限
执行job的用户名和密码
此时再次提交,Job执行成功
2 包括参数执行
仍然是用pytest这个job,只是添加了参数test(一个字符串的参数)
带参数执行的API地址,请求仍然是POST
http://192.168.6.224:8080/job/pythontest/buildWithParameters
仍然需要认证,参数可以设置为test="testonly"
此时提交job执行成功
JOB API--获取和更新描述信息:
通过API可以获取和更新JOB的description的信息
1.获取Description信息
API地址:http://192.168.6.224:8080/job/pythontest/description
(pythontest是job name)
请求方法"GET",不需要认证
2 更新Description信息
更新description的时候,API地址还是
http://192.168.6.224:8080/job/pythontest/description(pythontest是jobname)
只是请求方法为POST,添加一个参数 description,填写要更新的description的内容
同样需要身份验证
JOB API--禁用和启动Job:
1 禁用job
要禁用某一个job API地址 http://192.168.6.224:8080/job/pythontest/disable
请求方法是POST
执行成功,在jenkins中查看job ,此时已禁用
2 启用Job
之前的job,pythntest已经禁用,要重新启用这个job
API地址 http://192.168.6.224:8080/job/pythontest/enable(pythontest是job name)
请求方法是POST,执行后,job变成正常状态
JOB API--删除JOB:
要删除一个job,仍然可以通过API
地址 http://192.168.6.224:8080/job/pythontest/doDelete (pythntest是job name)
请求方法是post,需要认证
JOB API--JOB conofig.xml:
JOB的配置信息,通过地址 http://192.168.6.224:8080/job/pythontest/config.xml( pythntest是job name)
获取到的是一个xml的格式,这个里面包括了详细的配置信息,同样的地址通过post可以更新配置
主要是后面用这个config.xml可以用来创建job
站点 API:
站点所有相关的API,都是可以从地址http://192.168.6.224:8080/api 中查询到,同样可以查询job的相关信息等
但不同的是,还可以创建Job,拷贝Job,停止或重启Jenkis的服务
通过 http://192.168.6.224:8080/api/json?pretty=true (JSON) 可以查询到站点中所有的job信息
同样的XML地址是 http://192.168.6.224:8080/api/xml
查询同样支持,通过tree进行过滤
如通过 http://192.168.6.224:8080/api/json?pretty=true&tree=jobs[name[*]]
可以过滤出所有jobs的name
站点API_创建Job
要创建一个Job,首先要明白每个Job的配置信息都保存在config.xml中,如之前我们已经创建的job pythontest,通过访问地址
http://192.168.6.224:8080/job/pythontest/config.xml
就可以获得job相关的详细配置信息,当然需要先登录
config.xml的配置信息如下,这个里面包括了job的配置,包括名称,命令等
要创建一个新的Job,可以参考或复制这个config.xml文件
创建Job的API地址是http://192.168.6.224:8080/createItem
假设我们要新创建一个job,叫 “testjob”
那么第一步,要在Jenkins的安装目录下,找到子目录\jobs,然后在其中创建一个目录 ,就叫testjob
如果不创建这个目录,直接调用API,是会失败的
然后准备config.xml文件,作为job的配置信息,可以从刚才的pythontest的配置直接拷贝得到,然后简单修改下name
举例通过Postman进行,访问的API地址,请求方法为POST,需要身份验证
http://192.168.6.224:8080/createItem?name=testjob
地址后面的name就是要创建的job的name
在Header中创建 Content-Type,值为application/xml
请求的Boy中类型选择为binary
然后选择刚才准备的config.xml文件
此时调用,这个接口,Job可以创建成功
站点API_拷贝Job
要通过API拷贝一个已存在的Job,需要访问的API地址仍然是,请求还是POST
http://192.168.6.224:8080/createItem
再需要添加三个参数
分别是 name (复制后新创建的的job name,如pythontest2
mode(模式,固定给予值copy)
from( 要复制的Job的Job name,如pythontest)
站点API_重启
通过API地址 http://192.168.6.224:8080/restart
可以重启Jenkins
通过API地址 http://192.168.6.224:8080/safeRestart
可以安全重启Jenkins
参考文档:
1 https://wiki.jenkins.io/display/JENKINS/Remote+access+API
2 获取Jenkins project build结果 http://blog.csdn.net/ljj_9/article/details/70270977
Jenkins REST API 实例的更多相关文章
- PHP实现RESTful风格的API实例(三)
接前一篇PHP实现RESTful风格的API实例(二) .htaccess :重写URL,使URL以 /restful/class/1 形式访问文件 Options +FollowSymlinks R ...
- PHP实现RESTful风格的API实例(二)
接前一篇PHP实现RESTful风格的API实例(一) Response.php :包含一个Request类,即输出类.根据接收到的Content-Type,将Request类返回的数组拼接成对应的格 ...
- PHP实现RESTful风格的API实例(一)
最近看了一些关于RESTful的资料,自己动手也写了一个RESTful实例,以下是源码 目录详情: restful/ Request.php 数据操作类 Response.php 输出类 index. ...
- php版redis插件,SSDB数据库,增强型的Redis管理api实例
php版redis插件,SSDB数据库,增强型的Redis管理api实例 SSDB是一套基于LevelDB存储引擎的非关系型数据库(NOSQL),可用于取代Redis,更适合海量数据的存储.另外,ro ...
- 5.7 WebDriver API实例讲解
本节主要详细描述WebDriver的常用API使用方法. 1.访问某网页地址 被测试网页的网址:http://www.sogou.com. Java语言版本的API实例代码: 方法1: public ...
- 5.6 WebDriver API实例讲解(16-30)
16.操作单选框 被测试的网页为Demo1. Java语言版本的API实例代码: public static void operateRadio(){ driver.get("file:// ...
- 以太坊RPC机制与API实例
上一篇文章介绍了以太坊的基础知识,我们了解了web3.js的调用方式是通过以太坊RPC技术,本篇文章旨在研究如何开发.编译.运行与使用以太坊RPC接口. 关键字:以太坊,RPC,JSON-RPC,cl ...
- Postman+Newman+jenkins实现API自动化测试
最近自己在学习用postman+newman+jenkins实现API自动化测试,这里做个回顾和记录.(此次是在windows上进行的环境搭建) 一.说明 1.大致思路:利用postman做接口调试所 ...
- WebDriver API 实例详解(四)
三十一.使用页面的文字内容识别和处理新弹出的浏览器窗口 被测试网页的HTML源码: <html> <head> <meta charset="UTF-8&quo ...
随机推荐
- Linux centos 安装 Node.js
官网下载地址 https://nodejs.org/zh-cn/download/ 1.下载二进制文件 (x64) 相当于 https://nodejs.org/dist/v10.16.3/no ...
- Flink中的算子操作
一.Connect DataStream,DataStream -> ConnectedStream,连接两个保持他们类型的数据流,两个数据流被Connect之后,只是被放在了同一个流中,内部 ...
- Docker与数据:三种挂载方式
操作系统与存储 操作系统中将存储定义为 Volume(卷) ,这是对物理存储的逻辑抽象,以达到对物理存储提供有弹性的分割方式.另外,将外部存储关联到操作系统的动作定义为 Mount(挂载). Dock ...
- Git修改历史commit的author信息
前言 "嘀嗒嘀嗒",抬头看向墙上的钟表,此时已是凌晨1点.小明终于把Go语言圣经第二章的笔记写完,保存commit,提交,然后睡觉. 额,等等,不对,小明发现他用的是公司的git账 ...
- 跨域@RequestBody@RequestParam 和JSON.stringify
- Redis核心原理与实践--字符串实现原理
Redis是一个键值对数据库(key-value DB),下面是一个简单的Redis的命令: > SET msg "hello wolrd" 该命令将键"msg&q ...
- Django——Paginator分页功能练习
1.路由urls.py from django.contrib import admin from django.urls import path from app01.views import in ...
- Linux内核编译配置脚本
环境 宿主机平台:Ubuntu 16.04.6 目标机:iMX6ULL Linux内核编译配置脚本 在linux开发过程中熟练使用脚本可以大大简化命令行操作,同时对于需要经常重复操作的指令也是一种备忘 ...
- Python - 面向对象编程 - __init__() 构造方法
什么是构造方法 在创建类时, 可手动添加一个 __init__() 方法,称为构造方法,这是一个实例方法 构造方法用于创建实例对象时使用,每当创建一个类的实例对象时,Python 解释器都会自动调 ...
- 判断页面是在pc端还是移动端打开不同的页面
在pc端页面上的判断 var mobileAgent = new Array("iphone", "ipod", "ipad", " ...