ansible-inventory

Краткое описание

usage: ansible-inventory [-h] [--version] [-v] [-i INVENTORY] [-l SUBSET]
                      [--flush-cache] [--vault-id VAULT_IDS] [-J |
                      --vault-password-file VAULT_PASSWORD_FILES]
                      [--playbook-dir BASEDIR] [-e EXTRA_VARS] [--list]
                      [--host HOST] [--graph] [-y] [--toml] [--vars]
                      [--export] [--output OUTPUT_FILE]
                      [group]

Описание

используется для отображения или вывода настроенной инвентаризации в том виде, в котором её видит Ansible

Общие параметры

--export

При использовании –list выводить данные в формате, оптимизированном для экспорта, а не в виде точного представления результатов обработки Ansible

--flush-cache

очистить кэш фактов для каждого узла в инвентаризации

--graph

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

--host <HOST>

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

--list

Вывести сведения обо всех узлах; работает как скрипт инвентаризации

--output <OUTPUT_FILE>

При использовании –list записать инвентаризацию в файл, а не выводить на экран

--playbook-dir <BASEDIR>

Поскольку этот инструмент не использует плейбуки, используйте этот каталог вместо каталога плейбуков. Он задаёт относительный путь для многих функций, включая roles/, group_vars/ и т. д.

--toml

Использовать формат TOML вместо формата JSON по умолчанию; игнорируется при использовании –graph

--vars

Добавить переменные в отображение графа; учитывается только при использовании –graph

--vault-id

идентификатор хранилища, который нужно использовать. Этот аргумент можно указывать несколько раз.

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

файл с паролем хранилища

--version

показать номер версии программы, расположение файла конфигурации, настроенный путь поиска модулей, расположение модуля и исполняемого файла, затем завершить работу

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

запросить пароль хранилища

-e, --extra-vars

задать дополнительные переменные в формате ключ=значение или YAML/JSON; если указан файл, добавьте перед его именем символ @. Этот аргумент можно указывать несколько раз.

-h, --help

показать это справочное сообщение и завершить работу

-i, --inventory, --inventory-file

указать путь к инвентаризации узлов или список узлов, разделённых запятыми. Этот аргумент можно указывать несколько раз.

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

дополнительно ограничить список выбранных узлов с помощью шаблона

-v, --verbose

Заставляет Ansible выводить больше отладочных сообщений. Увеличение числа параметров -v повышает подробность вывода; встроенные плагины в настоящее время поддерживают до -vvvvvv. Рекомендуется начать с уровня -vvv; для отладки подключений может потребоваться -vvvv. Этот аргумент можно указывать несколько раз.

-y, --yaml

Использовать формат YAML вместо формата JSON по умолчанию; игнорируется при использовании –graph

АРГУМЕНТЫ

group

Имя группы в инвентаризации; используется при работе с –graph

Окружение

Можно задать следующие переменные окружения.

ANSIBLE_INVENTORY – Переопределяет файл инвентаризации Ansible по умолчанию

ANSIBLE_CONFIG – Переопределяет файл конфигурации Ansible по умолчанию

Для большинства параметров в ansible.cfg доступно множество других переменных

Файлы

/etc/ansible/hosts – Файл инвентаризации по умолчанию

/etc/ansible/ansible.cfg – Файл конфигурации, используемый при наличии

~/.ansible.cfg – Пользовательский файл конфигурации; при наличии переопределяет конфигурацию по умолчанию

Автор

Первоначальную версию Ansible написал Michael DeHaan.

Полный список участников разработки приведён в файле AUTHORS.

Лицензия

Ansible распространяется на условиях лицензии GPLv3+.

См. также

ansible(1), ansible-config(1), ansible-console(1), ansible-doc(1), ansible-galaxy(1), ansible-playbook(1), ansible-pull(1), ansible-vault(1)