ansible-inventory

ansible-inventory#

Утилита ansible-inventory используется для просмотра и выгрузки инвентаря Ansible. По умолчанию выводит данные в формате JSON, совместимом с выходными данными источников динамического инвентаря.

ansible-inventory [ARGUMENTS] [GROUP]

где:

  • ARGUMENTS – аргументы ansible-inventory.

  • GROUP – название группы в инвентаре (используется с --graph).

Аргументы утилиты:

--export#

Только при использовании --list.

Вывод инвентаря в формате, оптимизированном для экспорта.

--graph#

Генерация графа инвентаря.

Если указан шаблон, он должен быть названием группы.

Игнорирует параметр --limit.

--host <HOST>#

Вывод информации о конкретном узле в формате динамического инвентаря.

Игнорирует параметр --limit.

--list#

Вывод информации обо всех узлах в формате динамического инвентаря.

--output <OUTPUT_FILE>#

Вывод в указанный файл.

Только при использовании --list.

--playbook-dir <BASEDIR>#

Каталог, который будет использоваться в качестве замены каталога сценариев. Замена влияет на относительные пути к ролям, групповыми переменным и другим ресурсам.

--toml#

Вывод в формате TOML вместо JSON.

Не применяется к --graph.

--vars#

Добавление переменных в граф инвентаря (--graph).

Игнорируется, если --graph не указан.

--vault-id#

Идентификатор Ansible Vault.

Может быть указан несколько раз.

--vault-password-file, --vault-pass-file#

Путь к файлу с ключом для расшифровки секретов, хранящихся в Ansible Vault.

--version#

Вывод версии Ansible, пути к файлу настроек и пути поиска модулей.

-J, --ask-vault-password, --ask-vault-pass#

Включение запроса пароля хранилища.

-e, --extra-vars#

Передача дополнительных переменных в формате key=value, YAML или JSON.

Может быть указан несколько раз.

-h, --help#

Вывод справки.

-i, --inventory#

Путь к файлу инвентаря или список узлов через запятую. Поддерживает динамический инвентарь.

Может быть указан несколько раз.

-l <SUBSET>, --limit <SUBSET>#

Ограничение списка узлов, на которых выполняется команда.

-v, --verbose#

Включение подробного вывода, показывающего больше информации о выполнении команды.

Увеличение уровня детализации возможно при добавлении нескольких -v. Утилита может выводить до -vvvvvv. Рекомендуемый уровень для общей отладки – -vvv, для отладки соединений – -vvvv.

-y, --yaml#

Вывод в формате YAML вместо JSON.

Не применяется к --graph.

Примеры использования:

Вывод инвентаря в формате YAML#
ansible-inventory --list -y
Вывод информации о конкретном узле#
ansible-inventory --host example.com
Ограничение списка узлов шаблоном#
ansible-inventory -i inventory.ini -l webservers
Вывод графа инвентаря#
ansible-inventory --graph
Запись описания инвентаря в файл#
ansible-inventory --list --output inventory.json