tower_inventory_source – создание, обновление или удаление источника инвентаризации Ansible Tower.
Новая версия с 2.7.
Описание
- Создание, обновление или удаление источника инвентаризации Ansible Tower. См. https://www.ansible.com/tower для обзора.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- ansible-tower-cli >= 3.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credential - | Используемый для получения инвентаризации учетные данные. | |
| description - | По умолчанию: null | Описание источника инвентаризации. |
| 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 позволяют переопределять переменные, найденные в файле конфигурации источника. Например, с 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. | |
| tower_verify_ssl boolean |
| Вариант Tower, чтобы избежать проверки сертификатов. |
| update_cache_timeout - | Время в секундах, которое необходимо рассматривать синхронизацию инвентаризации как актуальную. Во время запуска задач и обратных вызовов система задач будет оценивать метку времени последней синхронизации. Если она старше, чем таймаут кэширования, она не считается актуальной, и будет выполнена новая синхронизация инвентаризации. | |
| update_on_launch boolean |
| Каждый раз, когда задача выполняется с использованием этой инвентаризации, обновить инвентаризацию из выбранного источника перед выполнением задач задачи. |
| update_on_project_update boolean |
| Этот параметр синхронизирует инвентаризацию при синхронизации проекта. Он может использоваться только с источником SCM. |
Примечания
Примечание
- Если 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
tower_verify_ssl: false
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
- Этот модуль поддерживается сообществом 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.7/modules/tower_inventory_source_module.html
