tower_group - создание, обновление или удаление группы Ansible Tower.
Новое в версии 2.3.
Обзор
- Создание, обновление или удаление групп Ansible Tower. См. https://www.ansible.com/tower для обзора.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется данный модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credential | Значение по умолчанию: Нет | Используемый для группы аутентификационный ключ. |
| description | Значение по умолчанию: Нет | Описание группы. |
| group_by | Значение по умолчанию: Нет | Ограничение автоматически создаваемых групп из источника инвентаризации. |
| instance_filters | Значение по умолчанию: Нет | Список фильтров для сопоставления хостов, разделённых запятыми. |
| inventory обязательно | Инвентаризация, в которую должна входить группа. | |
| name обязательно | Название группы. | |
| overwrite | Значение по умолчанию: нет | Удалить дочерние группы и хосты, отсутствующие в источнике. |
| overwrite_vars | Значение по умолчанию: Нет | Переопределение переменных в дочерних группах и хостах переменными из внешнего источника. |
| source |
null, | Источник для данной группы. |
| source_regions | Значение по умолчанию: Нет | Регионы для облачного провайдера. |
| source_script | Значение по умолчанию: Нет | Скрипт инвентаризации, используемый при типе группы "custom". |
| source_vars | Значение по умолчанию: Нет | Переопределение переменных из источника переменными из этого поля. |
| state |
| Желаемое состояние ресурса. |
| tower_config_file | Значение по умолчанию: Нет | Путь к конфигурационному файлу Tower. См. примечания. |
| tower_host | Значение по умолчанию: Нет | URL вашего экземпляра Tower. |
| tower_password | Значение по умолчанию: Нет | Пароль для вашего экземпляра Tower. |
| tower_username | Значение по умолчанию: Нет | Имя пользователя для вашего экземпляра Tower. |
| tower_verify_ssl | Значение по умолчанию: да | Отключить/разрешить небезопасные подключения к Tower. Если no, сертификаты SSL не будут проверены. Это следует использовать только на управляемых вами сайтах, использующих самоподписанные сертификаты. |
| update_on_launch | Значение по умолчанию: нет | Обновление данных инвентаризации из её источника каждый раз при запуске задания. |
| variables | Значение по умолчанию: Нет | Переменные для использования в группе, используйте «@» для файла. |
Примечания
Примечание
- Если config_file не предоставлен, мы попробуем использовать значения по умолчанию библиотеки tower-cli для поиска информации о вашем хосте Tower.
- config_file должен содержать конфигурацию Tower в следующем формате host=hostname username=username password=password
Примеры
- name: Add tower group
tower_group:
name: localhost
description: "Local Host Group"
inventory: "Local Inventory"
state: present
tower_config_file: "~/tower_cli.cfg"
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- 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_group_module.html