JenkinsAPI文档详解

Jenkins提供了强大的API接口，支持通过REST-like的方式进行访问。这些API接口几乎可以实现所有需要的操作功能，包括获取、触发、删除Job等。用户可以使用curl、wget和Postman等工具进行接口调用和调试。此外，Jenkins API支持三种主要格式：JSON、XML和Python，用户可以根据需求选择合适的格式进行数据交互。本文将详细介绍Jenkins API的不同访问方式、常见操作以及通过Python进行API封装的实用方法。

Jenkins API

Jenkins API 提供了丰富的接口，通过调用这些接口可以实现几乎所有的功能操作，包括获取、触发和删除 Job 等。Jenkins 的 Remote API 采用 REST-like 形式，可以通过 curl、wget 和 postman 等工具进行模拟请求和调试。

Jenkins API 示例

查看 API 文档

Jenkins API 没有统一的入口，而是采用 …/api/ 的 REST API 样式。其中，"…" 表示 Jenkins 资源的 URL。常见的资源包括：站点（实例）、Job 和 Build。可以通过 URL 地址查看 API 信息，例如：

插件管理: http://<Jenkins-Server-Address>/pluginManager/api/
节点管理: http://<Jenkins-Server-Address>/computer/api/
认证管理: http://<Jenkins-Server-Address>/credentials/api/

API 访问方式

一般情况下，Jenkins API 支持 JSON、XML 和 Python API 三种访问方式。以下是一些示例代码：

# JSON 格式示例
import requests
response = requests.get('http:///api/json')
data = response.json()

使用方法

站点 API

通过站点 API 可以获取 Jenkins 实例中的所有 job 信息，支持 JSON 和 XML 格式。以下是一些常用的 API：

- 获取所有 job 信息（JSON 格式）：http:///api/json?pretty=true

- 获取所有 job 信息（XML 格式）：http:///api/xml

- 重启站点： http:///restart

获取 Job 相关信息

可以通过 Job API 获取指定 Job 的详细信息，包括 builds 节点信息。

- 获取当前 API 说明：http:///job//api/

- 获取 Job 的 builds 节点信息：http:///job//api/json?pretty=true&tree=builds[*]

获取指定 Build 相关信息

通过 Build API 可以获取指定构建的详细信息。

- 获取指定构建信息（JSON 格式）：http:///job///api/json?pretty=true

Python API Wrappers

Jenkins 提供了多种 Python API 封装库，例如 jenkinsapi 和 python-jenkins。这些库可以帮助开发者更方便地与 Jenkins API 进行交互。

远程触发 Job

通过 API 可以远程触发 Jenkins Job，以下是使用 curl 工具的一个示例：

# 使用 curl 触发 Jenkins Job
crumb=$(curl -k -u ":" 'http:///crumbIssuer/api/xml?xpath=concat(//crumbRequestField,":",//crumb)')
curl -u ":" -H $crumb -X POST -s http:///buildWithParameters?token=testuser

API 触发示例

参考文献

通过 Jenkins API，开发者可以高效地管理 Jenkins 实例，实现自动化的 CI/CD 流程。

FAQ

问：什么是 Jenkins API，它的主要功能是什么？

答：Jenkins API 是一个提供丰富接口的系统，通过调用这些接口可以实现几乎所有的功能操作，包括获取、触发和删除 Jenkins Job 等。它采用 REST-like 形式，可以通过工具如 curl、wget 和 postman 进行模拟请求和调试。

问：如何查看 Jenkins API 文档？

答：Jenkins API 没有统一的入口，而是采用 …/api/ 的 REST API 样式。通过 Jenkins 资源的 URL 地址可以查看 API 信息。常见的资源包括站点、Job 和 Build。例如，插件管理可以通过 http://<Jenkins-Server-Address>/pluginManager/api/ 查看。

问：Jenkins API 支持哪几种访问方式？

答：Jenkins API 支持 JSON、XML 和 Python API 三种访问方式。开发者可以选择合适的方式获取数据，例如使用 Python 的 requests 库来获取 JSON 格式的数据。

问：如何通过 Jenkins API 获取所有 Job 的信息？

答：可以通过站点 API 获取 Jenkins 实例中的所有 Job 信息。以下是一些常用的 API：
- 获取所有 job 信息（JSON 格式）：http://<Jenkins-Server-Address>/api/json?pretty=true
- 获取所有 job 信息（XML 格式）：http://<Jenkins-Server-Address>/api/xml