Python调用Jenkins API构建项目并传递参数的完整指南

Jenkins安装方式与常见问题解决

Jenkins的安装过程相对简单，支持多种安装途径。常见的安装方式包括以下几种：

• 从官网下载RPM包进行手动安装，这种方式操作最为繁琐。
• 在CentOS系统中使用yum命令安装，或在Ubuntu系统中使用apt-get命令安装。不过，由于默认配置可能包含大量非必要组件，因此通常不推荐这种安装方式。
• 直接下载官网提供的WAR包进行部署。

本文示例中，我们选择直接下载WAR包的方式进行安装。

在正式安装前，可能会遇到一个常见的问题：公司服务器上已存在一个运行中的Jenkins实例，且所有参数均已配置完毕。因此，即使重新安装的版本使用了不同的文件夹和用户，每次访问Jenkins页面时，系统仍会直接跳转到旧版本的界面，而不会进入首次激活Jenkins的设置向导。

出现该问题的原因是：服务器环境中配置了JENKINS_HOME环境变量，而Jenkins在启动时会优先读取该变量指向的文件夹内的配置信息。

解决方法：可以在每次启动Jenkins时，手动指定新的JENKINS_HOME路径，例如设置为/data/jenkins2。这样Jenkins就不会读取旧版本的配置信息，从而避免冲突。

Python调用Jenkins API进行参数化构建

接下来，我们将通过Python API实现Jenkins的参数化构建。具体场景是：通过前端页面选择下拉框选项，将参数传递至后台Jenkins，Jenkins接收这些参数后，基于这些条件进行数据计算。

在Jenkins中创建项目时，需要添加参数化构建选项。

根据实际需求，添加相应数量的参数。

在Python环境中，需要安装python-jenkins库以支持API调用。

sudo pip install python-jenkins

以下是具体的Python代码实现：

import jenkins
server = jenkins.Jenkins('http://192.168.59.149:28080', username='jenkins', password='jenkins@!23')
server.build_job('jxInstantQuery')
server.build_job('jxInstantQuery2', {'param1': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', 'param2': 'bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb'})

在Jenkins项目中配置的Shell执行脚本如下：

最终构建效果如下图所示：

以上即为通过Python调用Jenkins API进行构建并传递参数的完整示例。如需了解更多关于Python调用Jenkins API的资料，请持续关注本站其他相关文章。