jenkins_jobJenkins任务管理模块

jenkins_job Jenkins任务管理模块

1. 概述

本模块是通过使用Jenkins的REST API来管理jenkins任务作业的。
远程主机需要安装有python-jenkins >= 0.4.12依赖。
官方文档 https://docs.ansible.com/ansible/latest/collections/community/general/jenkins_job_module.html

2. 参数

参数	描述
config string	xml配置文件，如果job作业不存在时，需要设置本参数
enable boolean	作业是否启用
name string required	作业名称
password string	连接jenkins服务器认证使用的密码
state string	指定作业是否创建或删除，可选值，present默认、absent
token string	API令牌
url string	Jenkins服务器的URL
user string	连接jenkins服务器的用户名
validate_certs boolean	是否验证SSL证书，默认yes

3. 官方示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
- name: Create a jenkins job using basic authentication
  community.general.jenkins_job:
    config: "{{ lookup('file', 'templates/test.xml') }}"
    name: test
    password: admin
    url: http://localhost:8080
    user: admin

- name: Create a jenkins job using the token
  community.general.jenkins_job:
    config: "{{ lookup('template', 'templates/test.xml.j2') }}"
    name: test
    token: asdfasfasfasdfasdfadfasfasdfasdfc
    url: http://localhost:8080
    user: admin

- name: Delete a jenkins job using basic authentication
  community.general.jenkins_job:
    name: test
    password: admin
    state: absent
    url: http://localhost:8080
    user: admin

- name: Delete a jenkins job using the token
  community.general.jenkins_job:
    name: test
    token: asdfasfasfasdfasdfadfasfasdfasdfc
    state: absent
    url: http://localhost:8080
    user: admin

- name: Disable a jenkins job using basic authentication
  community.general.jenkins_job:
    name: test
    password: admin
    enabled: false
    url: http://localhost:8080
    user: admin

- name: Disable a jenkins job using the token
  community.general.jenkins_job:
    name: test
    token: asdfasfasfasdfasdfadfasfasdfasdfc
    enabled: false
    url: http://localhost:8080
    user: admin