community.general.jenkins_job_facts – Получение информации о задачах Jenkins

Примечание

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

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

Для использования в книге задач укажите: community.general.jenkins_job_facts.

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

Описание

Этот модуль может использоваться для запроса информации о существующих задачах Jenkins.
Этот модуль назывался jenkins_job_info до Ansible 2.9. Использование не изменилось.

Требования

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

python-jenkins >= 0.4.12

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
color строка		Получить только задачи с заданным цветом статуса.
glob строка		Шаблон shell для имен задач Jenkins, о которых требуется получить информацию.
name строка		Точное имя задачи Jenkins, о которой требуется получить информацию.
password строка		Пароль для аутентификации на сервере Jenkins. Этот параметр обязателен, если `token` не указан.
token строка		Токен API, используемый для аутентификации на сервере Jenkins. Этот параметр обязателен, если `password` не указан.
url строка	По умолчанию: "http://localhost:8080"	URL сервера Jenkins.
user строка		Пользователь для аутентификации на сервере Jenkins.
validate_certs логическое	Варианты: no да ←	Если установлено значение `False`, сертификаты SSL не будут проверяться. Это следует устанавливать только для `False` на сайтах, контролируемых пользователем, с самозаверяющими сертификатами.

Примеры

# Get all Jenkins jobs using basic auth
- community.general.jenkins_job_info:
    user: admin
    password: hunter2
  register: my_jenkins_job_info

# Get all Jenkins jobs using the token
- community.general.jenkins_job_info:
    user: admin
    token: abcdefghijklmnop
  register: my_jenkins_job_info

# Get info about a single job using basic auth
- community.general.jenkins_job_info:
    name: some-job-name
    user: admin
    password: hunter2
  register: my_jenkins_job_info

# Get info about a single job in a folder using basic auth
- community.general.jenkins_job_info:
    name: some-folder-name/some-job-name
    user: admin
    password: hunter2
  register: my_jenkins_job_info

# Get info about jobs matching a shell glob using basic auth
- community.general.jenkins_job_info:
    glob: some-job-*
    user: admin
    password: hunter2
  register: my_jenkins_job_info

# Get info about all failing jobs using basic auth
- community.general.jenkins_job_info:
    color: red
    user: admin
    password: hunter2
  register: my_jenkins_job_info

# Get info about passing jobs matching a shell glob using basic auth
- community.general.jenkins_job_info:
    name: some-job-*
    color: blue
    user: admin
    password: hunter2
  register: my_jenkins_job_info

- name: Get the info from custom URL with token and validate_certs=False
  community.general.jenkins_job_info:
    user: admin
    token: 126df5c60d66c66e3b75b11104a16a8a
    url: https://jenkins.example.com
    validate_certs: False
  register: my_jenkins_job_info

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

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

Ключ	Возвращаемое значение	Описание
jobs список / элементы=строка	успех	Все найденные задачи, соответствующие указанным критериям. Пример: [{'color': 'синий', 'fullname': 'test-folder/test-job', 'name': 'test-job', 'url': 'http://localhost:8080/job/test-job/'}]

Авторы

Chris St. Pierre (@stpierre)

© 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_facts_module.html