community.general.virtualbox инвентаризация – источник инвентаризации virtualbox
Примечание
Этот плагин инвентаризации входит в коллекцию community.general (версия 9.5.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.virtualbox.
Обзор
- Получение хостов инвентаризации из локальной установки VirtualBox.
- Использует файл конфигурации YAML, который заканчивается на virtualbox.(yml|yaml) или vbox.(yml|yaml).
- inventory_hostname всегда равен ‘Имя’ виртуальной машины VirtualBox.
- Группам ВМ можно назначать группы, используя
VBoxManage. Несколько групп можно назначить, используя/в качестве разделителя. - Отдельный параметр
enable_advanced_group_parsingпозволяет изменить поведение группировки. Подробности см. в документации по параметрам.
Параметры
Параметр | Комментарии |
|---|---|
cache boolean | Включить/выключить кеширование исходных данных инвентаризации, требует настройки плагина кеша для работы. Выборы:
Настройка:
|
cache_connection string | Данные или путь соединения кеша, для подробностей см. документацию плагина кеша. Настройка:
|
cache_plugin string | Плагин кеша для использования с исходными данными инвентаризации. По умолчанию: Настройка:
|
cache_prefix string | Префикс для использования с файлами/таблицами плагина кеша По умолчанию: Настройка:
|
cache_timeout integer | Время кеширования в секундах По умолчанию: Настройка:
|
compose dictionary | Создать переменные из выражений Jinja2. По умолчанию: |
enable_advanced_group_parsing boolean added in community.general 9.2.0 | Правило парсинга групп по умолчанию (когда эта настройка установлена в Установка При включении, виртуальная машина, настроенная с помощью Выборы:
|
groups dictionary | Добавление хостов в группу на основе условных выражений Jinja2. По умолчанию: |
keyed_groups list / elements=dictionary | Добавление хостов в группу на основе значений переменной. По умолчанию: |
|
default_value string added in ansible-core 2.12 |
Значение по умолчанию, когда значение переменной хоста пустая строка. Этот параметр несовместим с |
|
key string |
Ключ из входного словаря, используемый для создания групп |
|
parent_group string |
родительская группа для группировки по ключу |
|
prefix string |
Имя группы по ключу начнётся с этого префикса По умолчанию: |
|
separator string |
Разделитель, используемый для создания имени группы по ключу По умолчанию: |
|
trailing_separator boolean added in ansible-core 2.12 |
Установите это значение в Этот параметр взаимоисключающий с Возможные значения:
|
leading_separator boolean added in ansible-core 2.11 | Используется совместно с keyed_groups. По умолчанию, группа с ключом, у которой нет префикса или разделителя, будет иметь имя, начинающееся с подчеркивания. Это потому, что по умолчанию префикс — «» а разделитель «_». Установите этот параметр в значение False, чтобы исключить ведущий подчеркивание (или другой разделитель), если не задан префикс. Если имя группы получено из отображения, разделитель по-прежнему используется для конкатенации элементов. Чтобы вообще не использовать разделитель в имени группы, установите разделитель для группы с ключом в пустую строку. Возможные значения:
|
network_info_path string | путь к свойству для запроса сетевой информации (ansible_host) По умолчанию: |
plugin string / обязательно | токен, который гарантирует, что это файл источника для плагина «virtualbox» Возможные значения:
|
query dictionary | создание переменных из свойств virtualbox По умолчанию: |
running_only boolean | переключает отображение всех ВМ или только тех, которые в данный момент запущены Возможные значения:
|
settings_password_file string | предоставьте файл, содержащий пароль настроек (эквивалент –settingspwfile) |
strict boolean | Если Так как возможно использовать факты в выражениях, они могут не всегда быть доступны, и мы игнорируем эти ошибки по умолчанию. Возможные значения:
|
use_extra_vars boolean added in ansible-core 2.11 | Объединить дополнительные переменные в доступные переменные для композиции (наивысший приоритет). Возможные значения:
Настройка:
|
Примеры
# file must be named vbox.yaml or vbox.yml
simple_config_file:
plugin: community.general.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: community.general.virtualbox
groups:
container: "'minis' in (inventory_hostname)"
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/virtualbox_inventory.html