tower – плагин динамической инвентаризации Ansible для Ansible Tower
Добавлено в версии 2.7.
Краткое описание
- Читает инвентаризации из Ansible Tower.
- Поддерживает чтение конфигурации как из файла YAML, так и из переменных окружения.
- При чтении из файла YAML его имя должно заканчиваться на tower.(yml|yaml) или tower_inventory.(yml|yaml); путь в команде должен иметь вид /path/to/tower_inventory.(yml|yaml). Если в файле конфигурации отсутствуют некоторые аргументы, этот плагин попытается получить их значения из переменных окружения.
- При чтении конфигурации из переменных окружения путь в команде должен быть @tower_inventory.
Параметры
| Параметр | Варианты/значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| host string / обязательный | env:TOWER_HOST | Сетевой адрес вашего узла Ansible Tower. | |
| include_metadata boolean добавлено в 2.8 |
| Выполнять дополнительные запросы, чтобы предоставить все переменные групп с метаданными об исходном узле Ansible Tower. | |
| inventory_id string / обязательный | env:TOWER_INVENTORY | Идентификатор инвентаризации Ansible Tower, которую необходимо импортировать. | |
| password string / обязательный | env:TOWER_PASSWORD | Пароль пользователя Ansible Tower. | |
| plugin - / обязательный |
| env:ANSIBLE_INVENTORY_ENABLED | имя этого плагина; для распознавания плагином себя в качестве собственного всегда должно быть задано значение 'tower'. |
| username string / обязательный | env:TOWER_USERNAME | Пользователь, от имени которого вы планируете получать доступ к инвентаризациям в Ansible Tower. | |
| validate_certs boolean |
| env:TOWER_VERIFY_SSL | Указывает, должна ли Ansible проверять SSL-сертификат узла Ansible Tower. синонимы: verify_ssl |
Примеры
# Before you execute the following commands, you should make sure this file is in your plugin path, # and you enabled this plugin. # Example for using tower_inventory.yml file plugin: tower host: your_ansible_tower_server_network_address username: your_ansible_tower_username password: your_ansible_tower_password inventory_id: the_ID_of_targeted_ansible_tower_inventory # Then you can run the following command. # If some of the arguments are missing, Ansible will attempt to read them from environment variables. # ansible-inventory -i /path/to/tower_inventory.yml --list # Example for reading from environment variables: # Set environment variables: # export TOWER_HOST=YOUR_TOWER_HOST_ADDRESS # export TOWER_USERNAME=YOUR_TOWER_USERNAME # export TOWER_PASSWORD=YOUR_TOWER_PASSWORD # export TOWER_INVENTORY=THE_ID_OF_TARGETED_INVENTORY # Read the inventory specified in TOWER_INVENTORY from Ansible Tower, and list them. # The inventory path must always be @tower_inventory if you are reading all settings from environment variables. # ansible-inventory -i @tower_inventory --list
Статус
- Обратная совместимость интерфейса этой инвентаризации не гарантируется. [предварительная версия]
- Эта инвентаризация поддерживается сообществом Ansible. [сообщество]
Авторы
- Matthew Jones (@matburt)
- Yunfan Zhang (@YunfanZhang42)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
Подсказка
Для параметров каждого типа записи задан приоритет от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 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/plugins/inventory/tower.html
