ovirt.ovirt.ovirt inventory – Источник инвентаризации oVirt
Примечание
Этот плагин инвентаризации входит в состав коллекции ovirt.ovirt (версия 3.2.0).
У вас, возможно, эта коллекция уже установлена, если вы используете пакет 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 / элементы=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 | Используется совместно с keyed_groups. По умолчанию, у ключевой группы, у которой не задан префикс или разделитель, имя начинается с подчеркивания. Это потому, что префикс по умолчанию — «», а разделитель — «_». Установите этот параметр в False, чтобы не включать ведущий подчеркивание (или другой разделитель), если не задан префикс. Если имя группы получено из сопоставления, разделитель все равно используется для конкатенации элементов. Чтобы вообще не использовать разделитель в имени группы, установите разделитель для ключевой группы в пустую строку. Варианты:
|
ovirt_cafile строка | путь к файлу CA ovirt-engine. Если параметр |
ovirt_hostname_preference список / элементы=строка | Список опций, определяющих порядок назначения имен хостов. См. https://ovirt.github.io/ovirt-engine-api-model/master/#types/vm для доступных атрибутов. По умолчанию: |
ovirt_insecure строка | Флаг булевого типа, указывающий, нужно ли проверять сертификат TLS сервера и имя хоста. |
ovirt_password строка / обязательно | |
ovirt_query_filter строка | Словарь с фильтрами ключевых значений для запроса виртуальных машин. См. https://ovirt.github.io/ovirt-engine-sdk/master/services.m.html#ovirtsdk4.services.VmsService.list для параметров фильтра. |
ovirt_url строка / обязательно | |
ovirt_username строка / обязательно | |
plugin строка / обязательно | Имя плагина, должно быть всегда равно «ovirt», чтобы плагин распознал его как собственный. Варианты:
|
strict булево | Если Так как в выражениях могут использоваться фактические данные, они могут не всегда быть доступны, и по умолчанию такие ошибки игнорируются. Варианты:
|
use_extra_vars булево добавлено в ansible-core 2.11 | Объединить дополнительные переменные с доступными переменными для композиции (высший приоритет). Варианты:
Настройка:
|
Примеры
# 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: no
max: 15
keyed_groups:
- key: cluster
prefix: 'cluster'
groups:
dev: "'dev' in tags"
compose:
ansible_host: devices["eth0"][0]
Ссылки на коллекцию
© 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/ovirt/ovirt/ovirt_inventory.html