community.general.jenkins_job – Управление задачами jenkins

Примечание

Этот плагин входит в состав коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.jenkins_job.

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

Управление задачами Jenkins с использованием API Jenkins REST.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python-jenkins >= 0.4.12

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
config строка		конфигурация в формате XML. Необходима, если задача еще не существует. Взаимоисключающее с `enabled`. Учитывается, если `state=present`.
enabled логическое значение	Варианты: нет да	Указывает, должна ли задача быть включена или отключена. Взаимоисключающее с `config`. Учитывается, если `state=present`.
name строка / обязательно		Имя задачи Jenkins.
password строка		Пароль для аутентификации на сервере Jenkins.
state строка	Варианты: present ← absent	Атрибут, указывающий, должна ли задача создаваться или удаляться.
token строка		Токен API, используемый для аутентификации вместо пароля.
url строка	Значение по умолчанию: "http://localhost:8080"	URL сервера Jenkins.
user строка		Пользователь для аутентификации на сервере Jenkins.

Примеры

- 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

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
enabled логическое значение	success	Включена ли задача jenkins. Пример: True
name строка	success	Имя задачи jenkins. Пример: test-job
state строка	success	Состояние задачи jenkins. Пример: present
url строка	success	URL для подключения к серверу Jenkins. Пример: https://jenkins.mydomain.com
user строка	success	Пользователь, используемый для аутентификации. Пример: admin

Авторы

Sergio Millan Rodriguez (@sermilrod)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/jenkins_job_module.html