jenkins_job – Manage jenkins jobs

Synopsis

  • Manage Jenkins jobs by using Jenkins REST API.

Requirements

The below requirements are needed on the host that executes this module.

  • python-jenkins >= 0.4.12

Parameters

Parameter Choices/Defaults Comments
config
-
config in XML format.
Required if job does not yet exist.
Mutually exclusive with enabled.
Considered if state=present.
enabled
boolean
    Choices:
  • no
  • yes
Whether the job should be enabled or disabled.
Mutually exclusive with config.
Considered if state=present.
name
- / required
Name of the Jenkins job.
password
-
Password to authenticate with the Jenkins server.
state
-
    Choices:
  • present ←
  • absent
Attribute that specifies if the job has to be created or deleted.
token
-
API token used to authenticate alternatively to password.
url
-
Default:
"http://localhost:8080"
URL where the Jenkins server is accessible.
user
-
User to authenticate with the Jenkins server.

Examples

# Create a jenkins job using basic authentication
- jenkins_job:
    config: "{{ lookup('file', 'templates/test.xml') }}"
    name: test
    password: admin
    url: http://localhost:8080
    user: admin

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

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

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

# Disable a jenkins job using basic authentication
- jenkins_job:
    name: test
    password: admin
    enabled: False
    url: http://localhost:8080
    user: admin

# Disable a jenkins job using the token
- jenkins_job:
    name: test
    token: asdfasfasfasdfasdfadfasfasdfasdfc
    enabled: False
    url: http://localhost:8080
    user: admin

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
enabled
boolean
success
Whether the jenkins job is enabled or not.

Sample:
True
name
string
success
Name of the jenkins job.

Sample:
test-job
state
string
success
State of the jenkins job.

Sample:
present
url
string
success
Url to connect to the Jenkins server.

Sample:
https://jenkins.mydomain.com
user
string
success
User used for authentication.

Sample:
admin


Status

Authors

  • Sergio Millan Rodriguez (@sermilrod)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.