virtualbox – источник инвентаризации virtualbox
Обзор
- Получение хостов инвентаризации из локальной установки virtualbox.
- Использует файл конфигурации YAML, который заканчивается на virtualbox.(yml|yaml) или vbox.(yml|yaml).
- inventory_hostname всегда является значением ‘Name’ экземпляра virtualbox.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| cache boolean |
| записи ini: [inventory] переменная среды:ANSIBLE_INVENTORY_CACHE | Включить/выключить кэширование исходных данных инвентаризации, требует настройки плагина кэша для работы. |
| cache_connection строка | записи ini: [defaults] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN_CONNECTION переменная среды:ANSIBLE_INVENTORY_CACHE_CONNECTION | Данные или путь к подключению кэша, для получения подробностей см. документацию плагина кэша. | |
| cache_plugin строка | По умолчанию: "память" | записи ini: [defaults] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN переменная среды:ANSIBLE_INVENTORY_CACHE_PLUGIN | Плагин кэша для использования исходных данных инвентаризации. |
| cache_prefix - | По умолчанию: "ansible_inventory_" | записи ini: [default] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN_PREFIX переменная среды:ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX | Префикс для использования файлов/таблиц плагина кэша |
| cache_timeout целое число | По умолчанию: 3600 | записи ini: [defaults] [inventory] переменная среды:ANSIBLE_CACHE_PLUGIN_TIMEOUT переменная среды:ANSIBLE_INVENTORY_CACHE_TIMEOUT | Срок действия кэша в секундах |
| compose словарь | По умолчанию: {} | Создать переменные из выражений jinja2. | |
| groups словарь | По умолчанию: {} | Добавить хосты в группу на основе условных выражений Jinja2. | |
| keyed_groups список | По умолчанию: [] | Добавить хосты в группу на основе значений переменной. | |
| network_info_path - | По умолчанию: "/VirtualBox/GuestInfo/Net/0/V4/IP" | путь к свойству для запроса сетевой информации (ansible_host) | |
| plugin - / обязательно |
| маркер, который гарантирует, что это исходный файл для плагина 'virtualbox' | |
| query словарь | По умолчанию: {} | создать переменные из свойств virtualbox | |
| running_only boolean | По умолчанию: "нет" | переключает отображение всех ВМ или только тех, которые в данный момент работают | |
| settings_password_file - | укажите файл, содержащий пароль настроек (эквивалентно --settingspwfile) | ||
| strict boolean |
| Если yes сделать недействительные записи ошибкой, в противном случае пропустить и продолжить.Поскольку в выражениях можно использовать факты, они могут не всегда быть доступны, и по умолчанию мы игнорируем эти ошибки. |
Примеры
# file must be named vbox.yaml or vbox.yml
simple_config_file:
plugin: virtualbox
settings_password_file: /etc/virtulbox/secrets
query:
logged_in_users: /VirtualBox/GuestInfo/OS/LoggedInUsersList
compose:
ansible_connection: ('indows' in vbox_Guest_OS)|ternary('winrm', 'ssh')
# add hosts (all match with minishift vm) to the group container if any of the vms are in ansible_inventory'
plugin: virtualbox
groups:
container: "'minis' in (inventory_hostname)"
Статус
- Гарантии обратной совместимости для этого инвентаризатора нет. [превью]
- Этот инвентаризатор поддерживается сообществом Ansible. [community]
Авторы
- НЕИЗВЕСТНО
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете редактировать этот документ, чтобы улучшить его.
Подсказка
Записи конфигурации для каждого типа записи имеют порядок приоритетов снизу вверх. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 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/virtualbox.html
