community.general.jenkins_build (2.5.9) — module

Install collection

Install with ansible-galaxy collection install community.general:==2.5.9

Add to requirements.yml

  collections:
    - name: community.general
      version: 2.5.9

Description

Manage Jenkins builds with Jenkins REST API.

Requirements

• python-jenkins >= 0.4.12

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Create a jenkins build using basic authentication
  community.general.jenkins_build:
    name: "test-check"
    args:
      cloud: "test"
      availability_zone: "test_az"
    user: admin
    password: asdfg
    url: http://localhost:8080

Inputs

    
url:
    default: http://localhost:8080
    description:
    - URL of the Jenkins server.
    type: str

args:
    description:
    - A list of parameters to pass to the build.
    type: dict

name:
    description:
    - Name of the Jenkins job to build.
    required: true
    type: str

user:
    description:
    - User to authenticate with the Jenkins server.
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Attribute that specifies if the build is to be created or deleted.
    type: str

token:
    description:
    - API token used to authenticate with the Jenkins server.
    type: str

password:
    description:
    - Password to authenticate with the Jenkins server.
    type: str

build_number:
    description:
    - An integer which specifies a build of a job. Is required to remove a build from
      the queue.
    type: int

Outputs

build_info:
  description: Build info of the jenkins job.
  returned: success
  type: dict
name:
  description: Name of the jenkins job.
  returned: success
  sample: test-job
  type: str
state:
  description: State of the jenkins job.
  returned: success
  sample: present
  type: str
url:
  description: Url to connect to the Jenkins server.
  returned: success
  sample: https://jenkins.mydomain.com
  type: str
user:
  description: User used for authentication.
  returned: success
  sample: admin
  type: str