tower_job_launch - Запуск задачи Ansible.
Новая версия с 2.3.
Обзор
- Запуск задач Ansible Tower. См. https://www.ansible.com/tower для обзора.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credential | Значение по умолчанию: None | Используемый ключ, только если запрошен ввод ключа. |
| extra_vars | Значение по умолчанию: None | Дополнительные переменные для шаблона задачи. Добавить «@» перед именем файла, если это файл. |
| inventory | Значение по умолчанию: None | Инвентаризация для задачи, только если запрошен ввод инвентаризации. |
| job_explanation | Значение по умолчанию: None | Поле описания задачи. |
| job_template обязательно | Имя шаблона задачи. | |
| job_type |
None | Тип задачи для задачи, только если запрошен ввод типа задачи. |
| limit | Значение по умолчанию: None | Ограничение для шаблона задачи. |
| tags | Значение по умолчанию: None | Указанные теги для использования из книги. |
| tower_config_file | Значение по умолчанию: None | Путь к конфигурационному файлу Tower. См. примечания. |
| tower_host | Значение по умолчанию: None | URL вашего экземпляра Tower. |
| tower_password | Значение по умолчанию: None | Пароль для вашего экземпляра Tower. |
| tower_username | Значение по умолчанию: None | Имя пользователя для вашего экземпляра Tower. |
| tower_verify_ssl | Значение по умолчанию: yes | Разрешить/запретить небезопасные подключения к Tower. Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых вами, с использованием самозаверяемых сертификатов. |
| use_job_endpoint | Значение по умолчанию: no | Отключить запуск задач из шаблона задачи. |
Примечания
Примечание
- Если 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 | success | Идентификатор новой запущенной задачи. Пример: 86 |
| status string | success | Статус новой запущенной задачи. Пример: pending |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантирует обратную совместимость.
Автор
- 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.5/modules/tower_job_launch_module.html