tower_job_launch – Запуск задачи Ansible
Новая версия с 2.3.
Обзор
- Запуск задач Ansible Tower. См. https://www.ansible.com/tower для обзора.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credential - | Используемый идентификатор для задачи, используется только если запрошен идентификатор. | |
| extra_vars - | Дополнительные переменные для использования в шаблоне задачи. Добавьте @ если это файл. | |
| 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. | |
| use_job_endpoint boolean |
| Отключить запуск задач из шаблона задачи. |
| validate_certs boolean |
| Разрешить ли небезопасные подключения к Tower. Если no, сертификаты SSL не будут проверены.Это следует использовать только на контролируемых вами сайтах с использованием самозаверенных сертификатов. алиасы: tower_verify_ssl |
Примечания
Примечание
- Если не указан config_file, мы попытаемся использовать значения по умолчанию библиотеки tower-cli для поиска информации о вашем хосте Tower.
- config_file должен содержать конфигурацию Tower в следующем формате: host=hostname username=username password=password
Примеры
# Launch a job template
- 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
# Launch job template with inventory and credential for prompt on launch
- name: Launch a job with inventory and credential
tower_job_launch:
job_template: "My Job Template"
inventory: "My Inventory"
credential: "My Credential"
register: job
- name: Wait for job max 120s
tower_job_wait:
job_id: "{{ job.id }}"
timeout: 120
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| id целое число | успех | Идентификатор задачи, только что запущенной задачи Пример: 86 |
| status строка | успех | Статус только что запущенной задачи Пример: ожидание |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.8/modules/tower_job_launch_module.html