community.general.opennebula инвентаризация – Источник инвентаризации OpenNebula

Примечание

Этот плагин инвентаризации входит в коллекцию community.general (версия 9.5.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в playbook, укажите: community.general.opennebula.

Новое в community.general 3.8.0

Обзор
Параметры
Примеры

Обзор

Получение хостов инвентаризации из облака OpenNebula.
Использует YAML-конфигурационный файл, заканчивающийся либо на opennebula.yml либо на opennebula.yaml, для установки значений параметров.
Использует api_authfile, ~/.one/one_auth, или ONE_AUTH для указания файла учетных данных OpenNebula.

Параметры

Параметр	Комментарии
api_authfile строка	Если оба `api_username` или `api_password` не заданы, то будет попытка аутентификации с помощью файла авторизации ONE. Путь по умолчанию `~/.one/one_auth`. Для изменения этого пути задайте переменную среды `ONE_AUTH`. Конфигурация: Переменная среды: `ONE_AUTH`
api_password строка	Пароль или токен пользователя для входа в сервер OpenNebula RPC. Если не задано, используется значение переменной среды `ONE_PASSWORD`. Конфигурация: Переменная среды: `ONE_PASSWORD`
api_url строка / обязательно	URL сервера OpenNebula RPC. Рекомендуется использовать HTTPS, чтобы имя пользователя/пароль не передавались по сети без шифрования. Если не задано, используется значение переменной среды `ONE_URL`. Конфигурация: Переменная среды: `ONE_URL`
api_username строка	Имя пользователя для входа в сервер OpenNebula RPC. Если не задано, используется значение переменной среды `ONE_USERNAME`. Конфигурация: Переменная среды: `ONE_USERNAME`
compose словарь	Создать переменные из выражений jinja2. По умолчанию: `{}`
filter_by_label строка	Возвращать только сервера, отфильтрованные по этому метке.
group_by_labels логическое	Создавать группы хостов по меткам виртуальных машин. Варианты: `false` `true` ← (по умолчанию)
groups словарь	Добавлять хосты в группы на основе условных выражений Jinja2. По умолчанию: `{}`
hostname строка	Поле для сопоставления имени хоста. Обратите внимание, что `v4_first_ip` соответствует первому найденному IPv4 на виртуальной машине. Варианты: `"v4_first_ip"` ← (по умолчанию) `"v6_first_ip"` `"name"`
keyed_groups список / элементы=словарь	Добавлять хосты в группы на основе значений переменной. По умолчанию: `[]`
default_value строка добавлено в ansible-core 2.12	Значение по умолчанию, когда значение переменной хоста — пустая строка. Этот параметр взаимоисключающий с `keyed_groups[].trailing_separator`.
key строка	Ключ из входного словаря, используемый для создания групп
parent_group строка	родительская группа для keyed группы
prefix строка	Имя ключированной группы будет начинаться с этого префикса По умолчанию: `""`
separator строка	Разделитель, используемый для построения имени ключированной группы По умолчанию: `"_"`
trailing_separator логическое добавлено в ansible-core 2.12	Установите этот параметр в `False`, чтобы опустить `keyed_groups[].separator` после переменной хоста, когда значение — пустая строка. Этот параметр взаимоисключающий с `keyed_groups[].default_value`. Варианты: `false` `true` ← (по умолчанию)

leading_separator boolean added in ansible-core 2.11	Используйте вместе с keyed_groups. По умолчанию, у группы с ключом, у которой нет префикса или разделителя, имя начинается с символа подчеркивания. Это связано с тем, что по умолчанию префикс — «» , а разделитель — «_». Установите это значение в False, чтобы опустить ведущий символ подчеркивания (или другой разделитель), если префикс не задан. Если имя группы получено из отображения, разделитель всё равно используется для конкатенации элементов. Чтобы вообще не использовать разделитель в имени группы, установите разделитель для группы с ключом в пустую строку. Выбираемые значения: `false` `true` ← (значение по умолчанию)
plugin string / обязательно	Токен, который гарантирует, что это файл источника для плагина ‘opennebula’. Выбираемые значения: `"community.general.opennebula"`
strict boolean	Если `yes` сделать недействительные записи ошибкой, иначе пропустить и продолжить. Поскольку в выражениях можно использовать факты, они могут быть не всегда доступны, и по умолчанию мы игнорируем эти ошибки. Выбираемые значения: `false` ← (значение по умолчанию) `true`
use_extra_vars boolean added in ansible-core 2.11	Объединить дополнительные переменные с доступными переменными для композиции (высший приоритет). Выбираемые значения: `false` ← (значение по умолчанию) `true` Настройка: Запись INI: [inventory_plugins] use_extra_vars = false Переменная среды: `ANSIBLE_INVENTORY_USE_EXTRA_VARS`

Примеры

# inventory_opennebula.yml file in YAML format
# Example command line: ansible-inventory --list -i inventory_opennebula.yml

# Pass a label filter to the API
plugin: community.general.opennebula
api_url: https://opennebula:2633/RPC2
filter_by_label: Cache

Авторы

Kristian Feldsam (@feldsam)

Подсказка

Записи конфигурации для каждого типа записи имеют низкий-высокий порядок приоритета. Например, переменная, которая ниже в списке, переопределит переменную, которая выше.

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

© 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/opennebula_inventory.html