tower_inventory_source – создание, обновление или удаление источника инвентаризации Ansible Tower
Новое в версии 2.7.
Обзор
- Создание, обновление или удаление источника инвентаризации Ansible Tower. См. https://www.ansible.com/tower для общего обзора.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credential - | Используемые учетные данные для получения инвентаризации. | |
| description - | Описание источника инвентаризации. | |
| group_by - | Укажите группы, которые нужно автоматически создать. Названия групп будут созданы аналогично выбранным параметрам. Если значение пустое, создаются все вышеуказанные группы. Подробные сведения см. в документации Ansible Tower. | |
| instance_filters - | Укажите список выражений фильтрации, разделенных запятыми. Хосты импортируются, когда все фильтры соответствуют условиям. Подробные сведения см. в документации Ansible Tower. | |
| inventory - / обязательно | Инвентаризация, к которой привязан источник. | |
| name - / обязательно | Имя источника инвентаризации. | |
| overwrite boolean |
| Если установлено, хосты и группы, ранее присутствовавшие во внешнем источнике, но теперь удаленные, будут удалены из инвентаризации Tower. Хосты и группы, которые не управлялись источником инвентаризации, будут переведены в следующую вручную созданную группу или, если нет вручную созданной группы, они останутся в группе «all» по умолчанию для инвентаризации. Если не установлено, локальные дочерние хосты и группы, отсутствующие во внешнем источнике, не будут затронуты процессом обновления инвентаризации. |
| overwrite_vars boolean |
| Если установлено, все переменные для дочерних групп и хостов будут удалены и заменены переменными, найденными во внешнем источнике. Если не установлено, выполнится слияние, объединяющее локальные переменные с переменными, найденными во внешнем источнике. |
| source - / обязательно |
| Типы источников инвентаризации. |
| source_path - | Путь к файлу, используемому в качестве источника в выбранном *проекте*. | |
| source_project - | Использование *проекта* в качестве источника для *инвентаризации*. | |
| source_regions - | Список регионов для вашего облачного провайдера. Можно включать несколько всех регионов. Обновляются только хосты, связанные с выбранными регионами. Подробные сведения см. в документации Ansible Tower. | |
| source_script - | Пользовательский скрипт источника для построения инвентаризации. Он должен существовать. | |
| source_vars - | source_vars позволяют перезаписывать переменные, найденные в файле конфигурации источника. Например, указав *private: false* в Openstack, вы измените вывод скрипта openstack.py. Должен быть в формате YAML или JSON. | |
| state - |
| Желаемое состояние ресурса. |
| timeout - | Количество секунд, по истечении которых методы API Tower будут остановлены из-за превышения времени ожидания. | |
| tower_config_file path | Путь к файлу конфигурации Tower. | |
| tower_host строка | URL вашего экземпляра Tower. | |
| tower_password строка | Пароль для вашего экземпляра Tower. | |
| tower_username строка | Имя пользователя для вашего экземпляра Tower. | |
| update_cache_timeout - | Время в секундах, считающее синхронизацию инвентаризации актуальной. Во время выполнения задач и обратных вызовов система задач будет оценивать отметку времени последней синхронизации. Если она старше, чем тайм-аут кеша, она не считается актуальной, и будет выполнена новая синхронизация инвентаризации. | |
| update_on_launch boolean |
| Каждый раз, когда задача запускается с помощью этой инвентаризации, обновляйте инвентаризацию из выбранного источника перед выполнением задач задачи. |
| update_on_project_update boolean |
| Этот параметр синхронизирует инвентаризацию при синхронизации проекта. Он может использоваться только с источником SCM. |
| validate_certs boolean |
| Вариант Tower для предотвращения проверки сертификатов. псевдонимы: tower_verify_ssl |
Примечания
Примечание
- Если config_file не указан, мы попытаемся использовать значения по умолчанию библиотеки tower-cli для поиска информации о вашем хосте Tower.
- config_file должен содержать конфигурацию Tower в следующем формате host=hostname username=username password=password
Примеры
- name: Add tower inventory source
tower_inventory_source:
name: Inventory source
description: My Inventory source
inventory: My inventory
credential: Devstack_credential
source: openstack
update_on_launch: true
overwrite: true
source_vars: '{ private: false }'
state: present
validate_certs: false
Статус
- Гарантируется, что у этого модуля не будет обратной совместимости. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Adrien Fleury (@fleu42)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/tower_inventory_source_module.html
