tower_job_launch - Запуск задания Ansible.
Новое в версии 2.3.
Обзор
- Запуск заданий Ansible Tower. См. https://www.ansible.com/tower для обзора.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credential | Используемый идентификатор учетной записи для задания, используется только если задан запрос для идентификатора учетной записи. | |
| extra_vars | Дополнительные переменные для использования в job_template. Добавить @ если это файл. | |
| inventory | Используемый инвентарь для задания, используется только если задан запрос для инвентаря. | |
| job_explanation | Поле объяснения задания. | |
| job_template обязательно | Имя используемой шаблона задания. | |
| job_type |
| Тип задания, используется только если задан запрос для типа задания. |
| limit | Ограничение, используемое для job_template. | |
| tags | Указанные теги, используемые из playbook. | |
| tower_config_file | Путь к конфигурационному файлу Tower. См. примечания. | |
| tower_host | URL вашего экземпляра Tower. | |
| tower_password | Пароль для вашего экземпляра Tower. | |
| tower_username | Имя пользователя для вашего экземпляра Tower. | |
| tower_verify_ssl bool |
| Отключить/разрешить небезопасные подключения к Tower. Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с использованием самозаверяющих сертификатов. |
| use_job_endpoint bool |
| Отключить запуск заданий из шаблона задания. |
Примечания
Примечание
- Если config_file не указан, мы попытаемся использовать значения по умолчанию библиотеки tower-cli для поиска информации о вашем хосте Tower.
- config_file должен содержать конфигурацию Tower в следующем формате: host=hostname username=username password=password
Примеры
- name: Launch a job
tower_job_launch:
job_template: "My Job Template"
register: job
- name: Wait for job max 120s
tower_job_wait:
job_id: job.id
timeout: 120
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| id int | успешно | id задания, которое только что было запущено Пример: 86 |
| status строка | успешно | статус только что запущенного задания Пример: ожидание |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и обслуживание модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Wayne Witzel III (@wwitzel3)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ для улучшения.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/tower_job_launch_module.html