ovirt.ovirt.ovirt inventory — источник инвентаризации oVirt
Примечание
Этот плагин инвентаризации входит в коллекцию ovirt.ovirt (версия 3.2.2).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install ovirt.ovirt. Для работы с этим плагином инвентаризации требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать плагин в плейбуке, укажите: ovirt.ovirt.ovirt.
Добавлено в ovirt.ovirt 1.0.0
Краткое описание
- Получение хостов инвентаризации из службы oVirt.
- Требуется файл YAML с расширением ‘ovirt.yml’, ‘ovirt4.yml’, ‘ovirt.yaml’ или ‘ovirt4.yaml’.
Требования
Следующие компоненты должны быть установлены на локальном управляющем узле, который выполняет инвентаризацию.
- ovirt-engine-sdk-python >= 4.2.4
Параметры
Параметр | Описание |
|---|---|
cache boolean | Включает или отключает кеширование исходных данных инвентаризации. Для работы требуется настроенный плагин кеша. Варианты:
Конфигурация:
|
cache_connection string | Данные подключения к кешу или путь к нему; подробности см. в документации плагина кеша. Конфигурация:
|
cache_plugin string | Плагин кеша для исходных данных инвентаризации. По умолчанию: Конфигурация:
|
cache_prefix string | Префикс для файлов/таблиц плагина кеша. По умолчанию: Конфигурация:
|
cache_timeout integer | Длительность хранения кеша в секундах. По умолчанию: Конфигурация:
|
compose dictionary | Создание переменных из выражений jinja2. По умолчанию: |
groups dictionary | Добавление хостов в группы на основе условий Jinja2. По умолчанию: |
keyed_groups list / elements=dictionary | Добавление хостов в группы на основе значений переменной. По умолчанию: |
|
default_value string добавлено в ansible-core 2.12 |
Значение по умолчанию, используемое, если значение переменной хоста равно Этот параметр несовместим с |
|
key string |
Ключ входного словаря, используемый для создания групп. |
|
parent_group string |
Родительская группа для группы, созданной по ключу. |
|
prefix string |
Имя группы, созданной по ключу, будет начинаться с этого префикса. По умолчанию: |
|
separator string |
Разделитель, используемый при формировании имени группы по ключу. По умолчанию: |
|
trailing_separator boolean добавлено в ansible-core 2.12 |
Установите для этого параметра значение Этот параметр несовместим с Варианты:
|
leading_separator boolean добавлено в ansible-core 2.11 | Используется совместно с По умолчанию имя группы, созданной по ключу, для которой не задан префикс или разделитель, начинается с символа подчёркивания. Это связано с тем, что префикс по умолчанию — Установите для этого параметра значение Если имя группы получено из соответствия, разделитель по-прежнему используется для объединения элементов. Чтобы не использовать разделитель в имени группы, задайте для группы по ключу пустую строку в качестве разделителя. Варианты:
|
ovirt_cafile string | Путь к файлу CA ovirt-engine. Если параметр |
ovirt_hostname_preference list / elements=string | Список параметров, определяющих порядок назначения имён хостам. Список доступных атрибутов см. на странице https://ovirt.github.io/ovirt-engine-api-model/master/#types/vm. По умолчанию: |
ovirt_insecure string | Логический флаг, указывающий, следует ли проверять TLS-сертификат сервера и имя хоста. |
ovirt_password string / обязательный | |
ovirt_query_filter string | Словарь пар ключ-значение фильтра для запроса виртуальных машин. Параметры фильтра см. на странице https://ovirt.github.io/ovirt-engine-sdk/master/services.m.html#ovirtsdk4.services.VmsService.list. |
ovirt_url string / обязательный | |
ovirt_username string / обязательный | |
plugin string / обязательный | Имя этого плагина. Чтобы плагин распознал конфигурацию как свою, здесь всегда должно быть указано ‘ovirt’. Варианты:
|
strict boolean | Если Поскольку в выражениях можно использовать факты, они могут быть доступны не всегда; по умолчанию такие ошибки игнорируются. Варианты:
|
use_extra_vars boolean добавлено в ansible-core 2.11 | Объединять дополнительные переменные с доступными переменными для композиции (наивысший приоритет). Варианты:
Конфигурация:
|
Примечание
Для записей конфигурации каждого типа (переменная Ansible, переменная среды и т. д.), перечисленных выше, порядок приоритета указан от низшего к высшему. Например, переменная, расположенная ниже в списке, переопределяет переменную, расположенную выше. Типы записей также упорядочены по приоритету от низшего к высшему. Например, запись ansible.cfg (расположенная выше в списке) переопределяется переменной Ansible (расположенной ниже в списке).
Примечания
Примечание
- На этом этапе формирование инвентаризации ещё не завершено, поэтому автоматически заполненные группы
allиungroupedбудут содержать только то, что в них явно добавили предыдущие источники инвентаризации. - Во время построения инвентаризации среда выполнения ещё не предоставляет «магические переменные». Например,
groupsиhostvarsещё не существуют.
Примеры
# Ensure the CA is available:
# $ wget "https://engine/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA" -O /path/to/ca.pem
# Sample content of ovirt.yml:
plugin: ovirt.ovirt.ovirt
ovirt_url: https://engine/ovirt-engine/api
ovirt_cafile: /path/to/ca.pem
ovirt_username: ansible-tester
ovirt_password: secure
ovirt_query_filter:
search: 'name=myvm AND cluster=mycluster'
case_sensitive: false
max: 15
keyed_groups:
- key: cluster
prefix: 'cluster'
groups:
dev: "'dev' in tags"
compose:
ansible_host: devices["eth0"][0]
Ссылки на коллекцию
© 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/ovirt/ovirt/ovirt_inventory.html