community.general.jenkins_node 模块 – 管理 Jenkins 节点
注意
此模块是 community.general 集合(版本 10.1.0)的一部分。
如果您正在使用 ansible
包,则可能已安装此集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.general
。您需要进一步的要求才能使用此模块,请参阅要求了解详情。
要在 playbook 中使用它,请指定:community.general.jenkins_node
。
community.general 10.0.0 中的新功能
概要
使用 Jenkins REST API 管理 Jenkins 节点。
要求
以下要求需要在执行此模块的主机上满足。
python-jenkins >= 0.4.12
参数
参数 |
注释 |
---|---|
指定后,设置 Jenkins 节点标签。 |
|
要管理的 Jenkins 节点的名称。 |
|
指定后,设置 Jenkins 节点执行器计数。 |
|
指定配置 Jenkins 节点状态时要设置的离线原因消息。 如果给定了 在内部, |
|
指定 Jenkins 节点应为 选择
|
|
用于与 Jenkins 服务器进行身份验证的 API 令牌。 |
|
Jenkins 服务器的 URL。 默认: |
|
用于与 Jenkins 服务器进行身份验证的用户。 |
属性
属性 |
支持 |
描述 |
---|---|---|
支持: 部分 检查模式无法显示尚未存在的节点的配置更改。 |
可以在 |
|
支持: 无 |
当处于 diff 模式时,将返回有关已更改(或可能需要在 |
示例
- name: Create a Jenkins node using token authentication
community.general.jenkins_node:
url: http://localhost:8080
user: jenkins
token: 11eb751baabb66c4d1cb8dc4e0fb142cde
name: my-node
state: present
- name: Set number of executors on Jenkins node
community.general.jenkins_node:
name: my-node
state: present
num_executors: 4
- name: Set labels on Jenkins node
community.general.jenkins_node:
name: my-node
state: present
labels:
- label-1
- label-2
- label-3
- name: Set Jenkins node offline with offline message.
community.general.jenkins_node:
name: my-node
state: disabled
offline_message: >
This node is offline for some reason.
返回值
常见的返回值记录在此处,以下是此模块独有的字段
键 |
描述 |
---|---|
Jenkins 节点是否已由任务配置。 已返回: 成功 |
|
Jenkins 节点是否已由任务创建。 已返回: 成功 |
|
Jenkins 节点是否已由任务删除。 已返回: 成功 |
|
Jenkins 节点是否已由任务禁用。 已返回: 成功 |
|
Jenkins 节点是否已由任务启用。 已返回: 成功 |
|
Jenkins 节点的名称。 已返回: 成功 示例: |
|
Jenkins 节点的状态。 已返回: 成功 示例: |
|
用于连接到 Jenkins 服务器的 URL。 已返回: 成功 示例: |
|
用于身份验证的用户。 已返回: 成功 示例: |