调用Jenkins接口api的几个例子

记录瞬间

近期操作Jenkins调用比较多，当然Jenkins本身也提供了jenkins-cli.jar的使用方法，可以直接通过命令行进行调用，

但是，由于不想引入太多的jar包，导致直接使用Jenkins api需求强烈

下面就把近期收集到的一些常见用法做一个简单总结，希望对初学者有所帮助。

9、直接调用Jenkins的job API进行构建的方法
Simple example - sending "String Parameters":

curl -X POST JENKINS_URL/job/JOB_NAME/build 
  --user USER:TOKEN 
  --data-urlencode json='{"parameter": [{"name":"id", "value":"123"}, {"name":"verbosity", "value":"high"}]}'
Another example - sending a "File Parameter":

curl -X POST JENKINS_URL/job/JOB_NAME/build 
  --user USER:PASSWORD 
  --form file0=@PATH_TO_FILE 
  --form json='{"parameter": [{"name":"FILE_LOCATION_AS_SET_IN_JENKINS", "file":"file0"}]}'
 
E.g.curl -X POST http://JENKINS_URL/job/JOB_NAME/build  --form file0=@/home/user/Desktop/sample.xml --form json='{"parameter": [{"name":"harness/Task.xml", "file":"file0"}]}'
Please note, in this example, the symbol '@' is important to mention. Also, the path to the file is absolute path.
In order to make this command work, you need to configure your Jenkins job to take a file parameter and 'name' in this command corresponds to 'file location' field in the Jenkins job configuration.
 
In above example, 'harness' is just a name of folder that may not exist in your workspace, you can write "name":"Task.xml" and it will place the Task.xml at root of your workspace.
Remember that name in this command should match with File location in file parameter in job configuration.


一个插件，可以通过此插件传参并调用Jenkins上的其他任务
Trigger/call builds on other projects
     Build Triggers


2.1运行jenkins-job
2.1.1无参任务curl -X POST http://localhost:8080/jenkins/job/plugin%20demo/build --user admin:admin
2.1.2含参任务
不设置参数/使用默认参数curl -X POST http://localhost:8080/jenkins/job/commandTest/buildWithParameters --user admin:admin
2.1.3设置参数方法1curl -X POST http://localhost:8080/jenkins/job/commandTest/buildWithParameters -d port=80
2.1.4设置参数方法2curl -X POST http://localhost:8080/jenkins/job/commandTest/buildWithParameters -d port=80 --data-urlencode json='"{"parameter": [{"name": "port", "value": "80"}]}”'
2.1.5多参数http://localhost:8080/jenkins/job/commandTest/buildWithParameters -d param1=value1&param2=value
2.2 创建job
2.2.1 需创建目录
1).创建job目录～/.jenkins/jobs/jobfromcmd
2).创建config.xml文件（可从其他工程中复制）
3).运行命令curl -X POST http://localhost:8080/jenkins/createItem?name=jobfromcmd --user admin:admin --data-binary "@config.xml" -H "Content-Type: text/xml”
2.2.2 不需创建目录
1).创建config.xml文件（可从其他工程中复制）
2).运行命令（在config.xml同一目录下）curl -X POST http://localhost:8080/jenkins/createItem?name=jobfromcmd --user admin:admin --data-binary "@config.xml" -H "Content-Type: text/xml”
2.2.3直接使用控制台,不需创建xml文件（将xml内容写入控制台中运行）echo '<?xml version="1.0" encoding="UTF-8"?><project>…</project>' | curl -X POST -H 'Content-type:text/xml' -d @- http://localhost:8080/jenkins/createItem?name=jobfromcmd
2.3 删除job curl -X POST http://localhost:8080/jenkins/job/jobfromcmd/doDelete
2.4 查询job的状态 curl --silent ${JENKINS_SERVER}/job/JOB_NAME/lastBuild/api/json
2.5 自动disable Project: curl --user ${UserName}:${PASSWORD} -o /dev/null --data disable JENKINS_URL/job/JOBNAME/disable
2.6获取build的num curl --silent ${JENKINS_SERVER}/job/JOB_NAME/lastBuild/buildNumber
2.7获取最近成功的build的num curl --silent ${JENKINS_SERVER}/job/JOB_NAME/lastStableBuild/buildNumber

2.8获取某一次构建结果信息 curl -o build.tmp2 -s --header n:${newbuild} ${jobPage}buildHistory/ajax
构建中：
<img height="16" alt="pending &gt; Console Output" width="16" src="/static/ea09c638/images/16x16/grey_anime.gif" tooltip="pending &gt; Console Output" />
排队中：
<img height="16" alt="In progress &gt; Console Output" width="16" src="/static/ea09c638/images/16x16/grey_anime.gif" tooltip="In progress &gt; Console Output" />
成功：           alt="成功 &gt; 控制台输出"
<img height="16" alt="Success &gt; Console Output" width="16" src="/static/ea09c638/images/16x16/blue.png" tooltip="Success &gt; Console Output" />
警告：
<img height="16" alt="Unstable &gt; Console Output" width="16" src="/static/ea09c638/images/16x16/yellow.png" tooltip="Unstable &gt; Console Output" />
失败：
<img height="16" alt="Aborted &gt; Console Output" width="16" src="/static/ea09c638/images/16x16/grey.png" tooltip="Aborted &gt; Console Output" />

l = ["123", "234", "098"]
for i in l:
    jenkins_url = "http://127.0.0.1:8080/jenkins/job/test/lastBuild/buildNumber"
    result = requests.get(jenkins_url)
    print("last build is : " + result.text)
    buildNumber = result.text

    j_url = "http://127.0.0.1:8080/jenkins/job/test/buildWithParameters"
    j_data = {"test": i}

    result = requests.post(j_url, data=j_data)
    print(result.text)

    while 1:
        jenkins_url = "http://127.0.0.1:8080/jenkins/job/test/buildHistory/ajax"
        headers = {"n": str(int(buildNumber) + 1)}
        print(headers)
        result = requests.get(jenkins_url, headers=headers)
        if 'alt="成功 &gt; 控制台输出"' in result.text or 
                'alt="Success &gt; Console Output"' in result.text:
            print("Yes !!!!!...")
            break
        else:
            time.sleep(2)
            print("sleep 1 second.")
            print(result.text)
其中可以直接将token放到url链接中，格式如下：
http://USER:API_TOKEN@Jenkins_IP:8080

Jenkins RestAPI调用出现Error 403 No valid crumb was included in the request
方法一（不推荐）：
在jenkins 的Configure Global Security下 , 取消“防止跨站点请求伪造（Prevent Cross Site Request Forgery exploits）”的勾选

方法二：
1、获取用户API token
http://Jenkins_IP:8080/user/zhangyi/configure
点击 show API Token，假设是API_TOKEN
2、计算CRUMB
CRUMB=$(curl -s 'http://USER:API_TOKEN@Jenkins_IP:8080/crumbIssuer/api/xml?xpath=concat(//crumbRequestField,":",//crumb)')
3、请求时附带CRUMB信息即可

curl -X POST -H "$CRUMB" http://USER:API_TOKEN@cd.web.tc.ted:8080/reload
 


可以使用如下链接对特定的job进行远程调用。
curl -X POST http://192.168.43.130:8080/jenkins/job/test/build --user xxx --data-urlencode json='{"parameter":[{"name":"v1","value":"123123"},{"name":"v2","value":"asdfghjkl"},{"name":"v3","value":"qwertyuiop"}]}'
获取最后一次执行的状态。
str=`curl --silent  http://192.168.43.130:8080/jenkins/job/test/lastBuild/api/json --user xxx | sed 's/,/ /g' | sed -r 's/.*"result":"([^ ]+)" .*/1/'`
echo $str
FAILURE 或者 SUCCESS 或者 null

增加一段python代码，用来实现一个小例子

# coding:utf-8
import os
import time
import zipfile
from xml.etree.ElementTree import ElementTree

import chardet
import requests


class GetJar(object):
    def __init__(self):
        self.data = {
            'mn': "xx/xx/xx",
            'app': "oo",
            'env': "wawo"
        }
        pass

    def create_json(self):
        base_path = "/jar"  # 根据不同环境需要进行配置的一个基础路径
        jar_info = {}
        back_path = base_path + '/' +self.data['mn'] + '/' + self.data['app']
        if not os.path.isdir(back_path):
            os.makedirs(back_path)
        jar_info['back_path'] = back_path
        jar_info["mn"] = self.data['mn']
        jar_info["app"] = self.data['app']
        jar_info["env"] = self.data['env']

        return jar_info

    # 检查pom文件是否存在jar包，并将jar包命名返回
    def check_pom_and_find_jar(self, root_path):
        jar_names = []
        for rt, dirs, files in os.walk(root_path):
            for fn in files:
                if fn == "pom.xml":
                    pom_file = os.path.join(rt, fn).replace("\", "/")
                    nodes, ns = self.get_xml_object(pom_file)
                    if nodes == '0' and ns == '0':
                        continue
                    art_id = ""
                    ver = ""
                    mark = 0
                    for child in nodes:
                        if child.tag == "{}parent".format(ns):
                            for sub in child:
                                if sub.tag == "{}version".format(ns):
                                    ver = sub.text
                        if child.tag == "{}version".format(ns):
                            ver = child.text
                        if child.tag == "{}artifactId".format(ns):
                            art_id = child.text
                        if child.tag == "{}packaging".format(ns) and child.text == "jar":
                            mark = 1
                    if mark == 1:
                        jar_names.append(art_id + "-" + ver + ".jar")
        return jar_names

    # 解析pom文件，如果没有jacoco插件，就按照特定方式进行插入
    def get_xml_object(self, pom_file):
        ns = ""
        mark = 0
        f_code = open(pom_file, 'rb')
        f_data = f_code.read()
        file_encoding = chardet.detect(f_data).get('encoding')
        f_code.close()
        try:
            with open(pom_file, encoding=file_encoding, mode="r") as pf:
                for line in pf.readlines():
                    # if line.startswith("<project "):
                    try:
                        ns_line = line.split("xmlns=")[1].split()[0]
                        if ">" in ns_line:
                            ns_line = ns_line.replace(">", '')
                        ns = "{" + "{}".format(ns_line.rstrip().replace('"', '')) + "}"
                        mark = 1
                    except Exception:
                        pass
                    if mark == 1:
                        break
        except Exception as e:
            print("文件 {} 非 UTF-8 编码 {}.{}.".format(pom_file, file_encoding, e))
            return "0", "0"

        tree = ElementTree()
        tree.parse(pom_file)

        return tree.getroot(), ns

    def get_jar(self, repo_path, sub_path='./'):
        jar_names = self.check_pom_and_find_jar(repo_path)
        print("展示所有的jar包名称： {}".format(jar_names))
        base_url = "http://Jenkins_job_url/"   # 需要替换一下！
        url_build = base_url + "buildWithParameters"
        url_num = base_url + "lastBuild/buildNumber"
        url_state = base_url + "buildHistory/ajax"
        jar_info = self.create_json()
        for jar in jar_names:
            # 获取最后一次的执行数字
            result = requests.get(url_num)
            buildNumber = result.text
            jar_info['jar_name'] = jar
            # 发送执行请求
            requests.post(url_build, data=jar_info)
            try:
                headers = {"n": str(int(buildNumber) + 1)}
            except Exception as e:
                print("解析最后一次Jenkins执行数据出错 - {}".format(e))
                continue
            while 1:
                # 查询发送后的状态
                result = requests.get(url_state, headers=headers)
                if 'alt="成功 &gt; 控制台输出"' in result.text or 
                        'alt="Success &gt; Console Output"' in result.text:
                    break
                else:
                    time.sleep(2)
                    print("sleep 2 second.")
            if os.path.isfile(jar_info['back_path'] + '/' + jar):
                zf = zipfile.ZipFile(jar_info['back_path'] + '/' + jar)
                try:
                    zf.extractall(path=sub_path + '/classes')
                except Exception as e:
                    print("解压缩失败 = {}".format(jar_info['back_path'] + '/' + jar))
                finally:
                    zf.close()


if __name__ == '__main__':
    jar = GetJar()
    jar.get_jar(r'/path/to/repo/')

====================底线====================