tower_job_template – создание, обновление или удаление шаблона задания Ansible Tower
Новая в версии 2.3.
Описание
- Создание, обновление или удаление шаблонов заданий Ansible Tower. См. https://www.ansible.com/tower для обзора.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ask_credential boolean |
| Запрашивать у пользователя данные учетной записи при запуске. |
| ask_diff_mode boolean добавлено в 2.7 |
| Запрашивать у пользователя разрешение на включение режима сравнения (отображение изменений) файлов, когда это поддерживается модулями. |
| ask_extra_vars boolean |
| Запрашивать у пользователя (extra_vars) при запуске. |
| ask_inventory boolean |
| Запрашивать у пользователя инвентаризацию при запуске. |
| ask_job_type boolean |
| Запрашивать у пользователя тип задания при запуске. |
| ask_limit boolean добавлено в 2.7 |
| Запрашивать у пользователя ограничение при запуске. |
| ask_skip_tags boolean добавлено в 2.7 |
| Запрашивать у пользователя метки заданий для пропуска при запуске. |
| ask_tags boolean |
| Запрашивать у пользователя метки заданий при запуске. |
| ask_verbosity boolean добавлено в 2.7 |
| Запрашивать у пользователя уровень подробности при запуске. |
| become_enabled boolean |
| Включить эскалацию привилегий. |
| concurrent_jobs_enabled boolean добавлено в 2.7 |
| Разрешить одновременные запуски шаблонов заданий. |
| credential - добавлено в 2.7 | Имя учетной записи для использования в шаблоне задания. | |
| description - | Описание, используемое для шаблона задания. | |
| diff_mode_enabled boolean добавлено в 2.7 |
| Включить режим сравнения для шаблона задания. |
| extra_vars_path - | Путь к файлу extra_vars YAML. | |
| fact_caching_enabled boolean добавлено в 2.7 |
| Включить использование кэширования фактов для шаблона задания. |
| force_handlers_enabled boolean добавлено в 2.7 |
| Включить принудительное выполнение обработчиков playbook, даже если задача завершается неудачно. |
| forks - | Количество параллельных или одновременных процессов для использования при выполнении playbook. | |
| host_config_key - | Разрешить вызовы обработки с помощью этого ключа конфигурации хоста. | |
| inventory - | Имя инвентаризации для использования в шаблоне задания. | |
| job_tags - | Список меток для шаблона задания, разделенный запятыми. | |
| job_type - / обязательно |
| Тип задания для использования в шаблоне задания. |
| limit - | Шаблон хоста для дальнейшего ограничения списка хостов, управляемых или затронутых playbook. | |
| name - / обязательно | Имя для использования в шаблоне задания. | |
| playbook - / обязательно | Путь к playbook для использования в шаблоне задания в предоставленном проекте. | |
| project - / обязательно | Имя проекта для использования в шаблоне задания. | |
| skip_tags - | Список меток для пропуска в шаблоне задания, разделенный запятыми. | |
| start_at_task - добавлено в 2.7 | Начать выполнение playbook с задачей с таким именем. | |
| state - |
| Желаемое состояние ресурса. |
| survey_enabled boolean добавлено в 2.7 |
| Включить опрос для шаблона задания. |
| survey_spec словарь добавлено в 2.8 | Определение опроса в формате JSON/YAML. | |
| tower_config_file путь | Путь к файлу конфигурации Tower. | |
| tower_host строка | URL вашего экземпляра Tower. | |
| tower_password строка | Пароль для вашего экземпляра Tower. | |
| tower_username строка | Имя пользователя для вашего экземпляра Tower. | |
| validate_certs boolean |
| Разрешить небезопасные подключения к Tower. Если no, сертификаты SSL не будут проверяться.Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов. алиасы: tower_verify_ssl |
| vault_credential - добавлено в 2.7 | Имя учетной записи хранилища для использования в шаблоне задания. |
| Уровень подробности - |
| Управляет уровнем подробности вывода, который Ansible производит во время выполнения книги задач. 0 - Нормальный, 1 - Подробно, 2 - Более подробный, 3 - Отладочный, 4 - Отладочный вывод соединения. |
Примечания
Примечание
- JSON для survey_spec можно найти в документации API Tower. Посмотрите https://docs.ansible.com/ansible-tower/latest/html/towerapi/api_ref.html#/Job_Templates/Job_Templates_job_templates_survey_spec_create для примера полезной нагрузки POST-операции.
- Если config_file не указан, мы попытаемся использовать значения по умолчанию библиотеки tower-cli для поиска информации о вашем хосте Tower.
- config_file должен содержать конфигурацию Tower в следующем формате: host=имя_хоста username=имя_пользователя password=пароль
Примеры
- name: Create tower Ping job template
tower_job_template:
name: "Ping"
job_type: "run"
inventory: "Local"
project: "Demo"
playbook: "ping.yml"
credential: "Local"
state: "present"
tower_config_file: "~/tower_cli.cfg"
survey_enabled: yes
survey_spec: "{{ lookup('file', 'my_survey.json') }}"
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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_template_module.html
