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. Хосты и группы, которые не управлялись источником инвентаризации, будут перенесены в следующую вручную созданную группу, или, если нет, оставятся в группе «все» по умолчанию для инвентаризации. При отсутствии выбора, локальные дочерние хосты и группы, отсутствующие во внешнем источнике, останутся нетронутыми процессом обновления инвентаризации. |
| overwrite_vars boolean |
| Если установлено, все переменные для дочерних групп и хостов будут удалены и заменены переменными из внешнего источника. При отсутствии выбора выполняется слияние, объединяющее локальные переменные с переменными из внешнего источника. |
| source - / обязательно |
| Типы источника инвентаризации. |
| source_path - | Путь к файлу, используемому в качестве источника в выбранном *проекте*. | |
| source_project - | Использование *проекта* в качестве источника для *инвентаризации*. | |
| source_regions - | Список регионов для вашего поставщика облачных услуг. Вы можете включить несколько всех регионов. Обновляются только хосты, связанные с выбранными регионами. Для получения дополнительной информации обратитесь к документации Ansible Tower. | |
| source_script - | Используемый кастомный скрипт источника для создания инвентаризации. Он должен существовать. | |
| source_vars - | source_vars позволяют переопределять переменные, найденные в конфигурационном файле источника. Например, в Openstack, указание *private: false* изменит вывод скрипта openstack.py. Он должен быть в формате YAML или JSON. | |
| state - |
| Желаемое состояние ресурса. |
| timeout - | Количество секунд, после которого методы API Tower будут прерваны из-за превышения времени ожидания. | |
| tower_config_file путь | Путь к конфигурационному файлу 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. [сообщество]
Авторы
- 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.8/modules/tower_inventory_source_module.html
