Spec-Zone.ru › Ansible

Инвентаризация 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’.

Варианты:

  • "name" ← (по умолчанию)
  • "uuid"

keyed_groups

список / элементы=словарь

Добавлять узлы в группы на основе значений переменной.

По умолчанию: []

default_value

строка

добавлено в ansible-core 2.12

Значение по умолчанию, если значение переменной узла равно None или является пустой строкой.

Этот параметр несовместим с keyed_groups[].trailing_separator.

key

строка

Ключ входного словаря, используемый для создания групп.

parent_group

строка

Родительская группа для группы, созданной по ключу.

prefix

строка

Имя группы, созданной по ключу, будет начинаться с этого префикса.

По умолчанию: ""

separator

строка

Разделитель, используемый для формирования имени группы, созданной по ключу.

По умолчанию: "_"

trailing_separator

логическое значение

добавлено в ansible-core 2.12

Установите для этого параметра значение false, чтобы опустить keyed_groups[].separator после переменной узла, если значение равно None или является пустой строкой.

Этот параметр несовместим с keyed_groups[].default_value.

Варианты:

  • false
  • true ← (по умолчанию)

leading_separator

логическое значение

добавлено в ansible-core 2.11

Используйте вместе с keyed_groups.

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

Это происходит потому, что префикс по умолчанию — "", а разделитель по умолчанию — "_".

Установите для этого параметра значение false, чтобы опустить начальный символ подчёркивания (или другой разделитель), если префикс не задан.

Если имя группы получено из сопоставления, разделитель всё равно используется для объединения элементов.

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

Варианты:

  • false
  • true ← (по умолчанию)

plugin

строка / обязательный

Токен, подтверждающий, что этот файл является исходным файлом для плагина ‘libvirt’.

Варианты:

  • "libvirt"
  • "community.libvirt.libvirt"

strict

логическое значение

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

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

Варианты:

  • false ← (по умолчанию)
  • true

uri

строка / обязательный

URI подключения к Libvirt

use_extra_vars

логическое значение

добавлено в ansible-core 2.11

Объединять дополнительные переменные с переменными, доступными для композиции (наивысший приоритет).

Варианты:

  • false ← (по умолчанию)
  • true

Конфигурация:

  • Запись INI:

    [inventory_plugins]
    use_extra_vars = false
    
  • Переменная окружения: ANSIBLE_INVENTORY_USE_EXTRA_VARS

Примечание

Указанные выше записи конфигурации для каждого типа записей (переменная 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'

Авторы

  • Dave Olsthoorn (@daveol)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API