如何获取在特定时间运行的 Jenkins 构建列表？

Question

我现在的Jenkins有大量的工作。不同的文件夹，每个文件夹都有多个作业。我最近看到一个 Jenkins 从服务器（自动缩放）在特定时间向另一台服务器发送了太多请求。但是，如果不手动检查它们，我无法找到在该特定时间运行的构建。有没有办法使用 API/Groovy 脚本获取这些信息？

Answer 1

我编写了一个非常小的 bash 脚本，在 jenkins 服务器上运行以解析日志文件。

仅查看作业开始时间是不够的。工作可能在您的时间窗口之前开始，甚至可能在您的时间窗口之后结束；它仍然会在您的时间窗口内运行。

#!/bin/bash
start=$1
end=$2

for build_xml in jobs/*/branches/*/builds/*/build.xml
do
        startTime=$(sed -n -e "s/.*<startTime>\(.*\)<\/startTime>.*/\1/p" $build_xml)
        modificationTime=$(date '+%s' -r $build_xml)
        if [[ $modificationTime > $start ]] && [[ $startTime < $end ]]
        then
                echo "START $(date -d @${startTime::-3})   END $(date -d @$modificationTime)   : $build_xml"
        fi
done

用途：

./getBuildsRunningBetween.sh 1565535639 1565582439

会给出：

START Sun Aug 11 20:29:00 CEST 2019   END Sun Aug 11 20:30:20 CEST 2019   : jobs/job-name/branches/branch-name/builds/277/build.xml

Answer 2

可以使用下面的 Jenkins API 根据称为动漫的颜色分类找到正在运行的作业。

“Jenkins 主机 url”/api/xml?tree=jobs[名称，url，颜色]&xpath=/hudson/job[ends-with(color/text(),%22_anime%22)]&wrapper=jobs

蓝色的是正在运行的

蓝色_动漫

Answer 3

这可以通过简单的 python 脚本和 Jenkins JSON REST API 轻松实现。

1.先决条件

已安装

Python 2.7 或 3.x 和 python requests 库：

pip install requests

对于Python 3.x

pip3 install requests

另外：如何安装pip

2.用于获取日期之间构建的Python脚本

import requests
from datetime import datetime


jenkins_url = "JENKINS_HOST"
username = "USERNAME"
password = "PASSWORD"
job_name = "JOB_NAME"
stop_date = datetime.strptime('23.11.2018 0:30:00', "%d.%m.%Y %H:%M:%S")        
start_date = datetime.strptime('10.11.2018 18:46:04', "%d.%m.%Y %H:%M:%S") 
request_url = "{0:s}/job/{1:s}/api/json{2:s}".format(
    jenkins_url,
    job_name,
    "?tree=builds[fullDisplayName,id,number,timestamp,url]"
)

response = requests.get(request_url, auth=(username, password)).json()
builds = []

for build in response['builds']:
    build_date = datetime.utcfromtimestamp(build['timestamp']/1000)
    if build_date >= start_date and build_date <= stop_date:
        builds.append(build)
        print("Job name: {0:s}".format(build["fullDisplayName"]))
        print("Build number: {0:d}".format(build["number"]))
        print("Build url: {0:s}".format(build["url"]))
        print("Build timestamp: {0:d}".format(build["timestamp"]))
        print("Build date: {}\n".format(build_date))

上面的脚本适用于 python 2.7 和 3.x。现在稍微解释一下：

首先使用 JSON API 下载所有构建数据并将响应加载为 JSON。然后，对于每个构建，将其时间戳转换为日期时间，并与开始日期和停止日期进行比较。请注意，将时间戳除以 1000 以获得秒而不是毫秒（否则从时间戳进行日期转换将引发 ValueError），这一点很重要。

输出示例：

$ python test.py 
Job name: Dummy #21
Build number: 21
Build url: http://localhost:8080/job/Dummy/21/
Build timestamp: 1541875585881
Build date: 2018-11-10 18:46:25

Job name: Dummy #20
Build number: 20
Build url: http://localhost:8080/job/Dummy/20/
Build timestamp: 1541875564250
Build date: 2018-11-10 18:46:04

另一方面，如果您想以不同的格式提供开始和停止日期，请记住您需要在

strptime()

函数中调整格式参数。 Python 日期时间指令。

几个例子：

datetime.strptime("23.11.2018", "%d.%m.%Y")
datetime.strptime("2018.11.23", "%Y.%m.%d")
datetime.strptime("Jun 1 2005  1:33PM", "%b %d %Y %I:%M%p")

3.用于获取确切日期构建的Python脚本

如果您有兴趣按确切日期查找构建，只需替换此行：

if build_date >= start_date and build_date <= stop_date:

这样：

if build_date == date:

其中

date

是特定的构建日期。

请注意！，如果您想按确切日期查找构建，您需要提供正确格式的

date

。在这种情况下，它是

"%d.%m.%Y %H:%M:%S"

。示例：

datetime.strptime('10.11.2018 18:46:04', "%d.%m.%Y %H:%M:%S")

否则，即使对于Python来说日期在某个点（分钟、小时、日期等）相同，它也不会是相等的日期。

如果您想提供其他格式，那么您需要调整

build_date

变量。

build_date.strftime('%d %m,%Y')