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
raw / обязательно
|
env:TOWER_INVENTORY
|
Идентификатор инвентаря Ansible Tower, который требуется импортировать.
В качестве него можно указать первичный ключ инвентаря или его именованный URL-сегмент.
Значения первичного ключа принимаются в виде строк или целых чисел, а URL-сегменты должны быть строками.
Именованные URL-сегменты имеют формат "inventory_name++organization_name".
|
|
|
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
Статус
- Для этого инвентаря не гарантируется обратная совместимость интерфейса. [preview]
- Этот инвентарь поддерживается сообществом Ansible. [community]
Авторы
- 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.9/plugins/inventory/tower.html
