tower – Ansible dynamic inventory plugin for Ansible Tower.
New in version 2.7.
Обзор
- Считывает инвентаризацию из Ansible Tower.
- Поддерживает чтение конфигурации как из файла конфигурации YAML, так и из переменных среды.
- Если чтение производится из файла YAML, имя файла должно оканчиваться на tower.(yml|yaml) или tower_inventory.(yml|yaml), путь в команде будет /path/to/tower_inventory.(yml|yaml). Если некоторые аргументы в файле конфигурации отсутствуют, этот плагин попытается заполнить отсутствующие аргументы, считывая их из переменных среды.
- Если конфигурация считывается из переменных среды, путь в команде должен быть @tower_inventory.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| host строка / обязательно | env:TOWER_HOST | Сеть адрес вашего хоста Ansible Tower. | |
| inventory_id строка / обязательно | env:TOWER_INVENTORY | Идентификатор инвентаризации Ansible Tower, которую вы хотите импортировать. | |
| password строка / обязательно | env:TOWER_PASSWORD | Пароль для вашего пользователя Ansible Tower. | |
| plugin - / обязательно |
| env:ANSIBLE_INVENTORY_ENABLED | имя этого плагина, оно всегда должно быть 'tower', чтобы этот плагин распознал его как свой. |
| username строка / обязательно | env:TOWER_USERNAME | Имя пользователя, которое вы планируете использовать для доступа к инвентаризации в Ansible Tower. | |
| verify_ssl логический тип |
| env:TOWER_VERIFY_SSL | Укажите, должен ли Ansible проверять сертификат SSL хоста Ansible Tower. |
Примеры
# 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
Статус
Авторы
- 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.7/plugins/inventory/tower.html
