Инвентаризация community.libvirt.libvirt — источник инвентаризации Libvirt
Примечание
Этот плагин инвентаризации входит в коллекцию community.libvirt (версия 2.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.libvirt. Для использования этого плагина инвентаризации необходимы дополнительные требования. Подробнее см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: community.libvirt.libvirt.
Добавлено в community.libvirt 2.10.0
Краткое описание
- Получение гостей libvirt из источника инвентаризации.
Требования
Следующие требования должны быть выполнены на локальном управляющем узле, который выполняет эту инвентаризацию.
- python >= 2.6
- привязки Python для libvirt
- lxml
Параметры
Параметр | Комментарии |
|---|---|
compose словарь | Создавать переменные на основе выражений Jinja2. По умолчанию: |
groups словарь | Добавлять узлы в группы на основе условий Jinja2. По умолчанию: |
inventory_hostname строка | Имя узла, которое будет зарегистрировано в инвентаризации. Если указано значение ‘uuid’, будет использоваться uuid сервера и для имени сервера будет создана группа. Если указано значение ‘name’, будет использоваться имя сервера, кроме случаев, когда существует несколько серверов с одинаковым именем; в этом случае будет применена логика ‘uuid’. По умолчанию используется ‘name’. Варианты:
|
keyed_groups список / элементы=словарь | Добавлять узлы в группы на основе значений переменной. По умолчанию: |
|
default_value строка добавлено в ansible-core 2.12 |
Значение по умолчанию, если значение переменной узла равно Этот параметр несовместим с |
|
key строка |
Ключ входного словаря, используемый для создания групп. |
|
parent_group строка |
Родительская группа для группы, созданной по ключу. |
|
prefix строка |
Имя группы, созданной по ключу, будет начинаться с этого префикса. По умолчанию: |
|
separator строка |
Разделитель, используемый для формирования имени группы, созданной по ключу. По умолчанию: |
|
trailing_separator логическое значение добавлено в ansible-core 2.12 |
Установите для этого параметра значение Этот параметр несовместим с Варианты:
|
leading_separator логическое значение добавлено в ansible-core 2.11 | Используйте вместе с По умолчанию имя группы, созданной по ключу, для которой не задан префикс или разделитель, начинается с символа подчёркивания. Это происходит потому, что префикс по умолчанию — Установите для этого параметра значение Если имя группы получено из сопоставления, разделитель всё равно используется для объединения элементов. Чтобы вообще не использовать разделитель в имени группы, задайте для группы, созданной по ключу, пустую строку в качестве разделителя. Варианты:
|
plugin строка / обязательный | Токен, подтверждающий, что этот файл является исходным файлом для плагина ‘libvirt’. Варианты:
|
strict логическое значение | Если Поскольку в выражениях можно использовать факты, они могут быть доступны не всегда; по умолчанию такие ошибки игнорируются. Варианты:
|
uri строка / обязательный | URI подключения к Libvirt |
use_extra_vars логическое значение добавлено в ansible-core 2.11 | Объединять дополнительные переменные с переменными, доступными для композиции (наивысший приоритет). Варианты:
Конфигурация:
|
Примечание
Указанные выше записи конфигурации для каждого типа записей (переменная Ansible, переменная окружения и т. д.) упорядочены от низкого к высокому приоритету. Например, переменная, расположенная ниже в списке, переопределяет переменную, расположенную выше. Типы записей также упорядочены по приоритету от низкого к высокому. Например, запись в ansible.cfg (расположенная выше в списке) переопределяется переменной Ansible (расположенной ниже в списке).
Примечания
Примечание
- На этом этапе инвентаризация ещё не окончательно сформирована, поэтому автоматически заполненные группы
allиungroupedбудут содержать только то, что в них явно добавили предыдущие источники инвентаризации. - Во время формирования инвентаризации недоступны динамические «магические переменные». Например,
groupsиhostvarsещё не существуют.
Примеры
# Connect to lxc host plugin: community.libvirt.libvirt uri: 'lxc:///' # Connect to qemu plugin: community.libvirt.libvirt uri: 'qemu:///system'
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/libvirt/libvirt_inventory.html