jenkins_job_facts – Получение сведений о задачах Jenkins
Новая версия 2.5.
Обзор
- Этот модуль может использоваться для запроса сведений о существующих задачах Jenkins.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python-jenkins >= 0.4.12
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| color - | Получить только задачи с заданным цветом статуса. | |
| glob - | Шаблон оболочки для имен задач Jenkins для получения сведений. | |
| name - | Точное имя задачи Jenkins для получения сведений. | |
| password - | Пароль для аутентификации на сервере Jenkins. Этот параметр обязателен, если token не указан. | |
| token - | Токен API для аутентификации на сервере Jenkins. Этот параметр обязателен, если password не указан. | |
| url - | Значение по умолчанию: "http://localhost:8080" | URL сервера Jenkins. |
| user - | Пользователь для аутентификации на сервере Jenkins. | |
| validate_certs boolean добавлен в 2.6 |
| Если установлено False, сертификаты SSL не будут проверяться.Это следует установить только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов. |
Примеры
# Get all Jenkins jobs using basic auth
- jenkins_job_facts:
user: admin
password: hunter2
register: my_jenkins_job_facts
# Get all Jenkins jobs using the token
- jenkins_job_facts:
user: admin
token: abcdefghijklmnop
register: my_jenkins_job_facts
# Get facts about a single job using basic auth
- jenkins_job_facts:
name: some-job-name
user: admin
password: hunter2
register: my_jenkins_job_facts
# Get facts about a single job in a folder using basic auth
- jenkins_job_facts:
name: some-folder-name/some-job-name
user: admin
password: hunter2
register: my_jenkins_job_facts
# Get facts about jobs matching a shell glob using basic auth
- jenkins_job_facts:
glob: some-job-*
user: admin
password: hunter2
register: my_jenkins_job_facts
# Get facts about all failing jobs using basic auth
- jenkins_job_facts:
color: red
user: admin
password: hunter2
register: my_jenkins_job_facts
# Get facts about passing jobs matching a shell glob using basic auth
- jenkins_job_facts:
name: some-job-*
color: blue
user: admin
password: hunter2
register: my_jenkins_job_facts
- name: Get the facts from custom URL with token and validate_certs=False
jenkins_job_facts:
user: admin
token: 126df5c60d66c66e3b75b11104a16a8a
url: https://jenkins.example.com
validate_certs: False
register: my_jenkins_job_facts
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| jobs список | успех | Все найденные задачи, соответствующие указанным критериям Пример: [{'name': 'test-job', 'fullname': 'test-folder/test-job', 'url': 'http://localhost:8080/job/test-job/', 'color': 'blue'}] |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/jenkins_job_facts_module.html