community.general.lxd инвентаризация — Возвращает инвентаризацию Ansible из хоста lxd

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого плагина инвентаризации требуются дополнительные зависимости. Подробности см. в разделе Требования.

Чтобы использовать его в книге задач, укажите: community.general.lxd.

Новое в community.general 3.0.0

Описание
Требования
Параметры
Примеры

Описание

Получение инвентаризации из lxd.
Использует файл конфигурации YAML, который заканчивается ‘lxd.(yml|yaml)’.

Требования

Ниже перечислены требования к локальному контроллеру, на котором выполняется эта инвентаризация.

ipaddress
lxd >= 4.0

Параметры

Параметр	Комментарии
client_cert псевдонимы: cert_file путь	Путь к файлу клиента сертификата. По умолчанию: `"$HOME/.config/lxc/client.crt"`
client_key псевдонимы: key_file путь	Путь к файлу ключа клиента сертификата. По умолчанию: `"$HOME/.config/lxc/client.key"`
groupby словарь	Создать группы по следующим ключевым словам `location`, `network_range`, `os`, `pattern`, `profile`, `release`, `type`, `vlanid`. См. пример для синтаксиса.
plugin строка / обязательно	Токен, гарантирующий, что это исходный файл для плагина ‘lxd’. Варианты: `"community.general.lxd"`
prefered_instance_network_family строка	Если у экземпляра несколько сетевых интерфейсов, какой предпочтительнее по семейству. Укажите `inet` для IPv4 и `inet6` для IPv6. Варианты: `"inet"` ← (по умолчанию) `"inet6"`
prefered_instance_network_interface псевдонимы: prefered_container_network_interface строка	Если у экземпляра несколько сетевых интерфейсов, выберите предпочтительный по шаблону. В сочетании с первой найденной цифрой, например, ‘eth’ + 0. Параметр был переименован из `prefered_container_network_interface` в `prefered_instance_network_interface` в community.general 3.8.0. Старое имя по-прежнему работает как псевдоним. По умолчанию: `"eth"`
project строка добавлено в community.general 6.2.0	Фильтрует экземпляры по заданному проекту. По умолчанию: `"default"`
server_cert путь добавлено в community.general 8.0.0	Путь к файлу сертификата сервера.
server_check_hostname булево добавлено в community.general 8.0.0	Этот параметр контролирует, проверяется ли имя хоста сервера как часть проверки подлинности соединения HTTPS. Это может быть полезно для отключения, если, например, предоставленный сертификат сервера (см. параметр `server_cert`) не охватывает имя, соответствующее используемому для связи с сервером. Такое несоответствие часто встречается, так как LXD по умолчанию генерирует самозаверяющие сертификаты сервера. Варианты: `false` `true` ← (по умолчанию)
state строка	Фильтрация экземпляра по текущему статусу. Варианты: `"STOPPED"` `"STARTING"` `"RUNNING"` `"none"` ← (по умолчанию)
trust_password строка	Защищённый пароль клиента. Вам необходимо установить этот пароль на сервере lxd перед запуском данного модуля, используя следующую команду `lxc config set core.trust_password <some random password>`. См. https://documentation.ubuntu.com/lxd/en/latest/authentication/#adding-client-certificates-using-a-trust-password. Если `trust_password` задано, этот модуль отправит запрос на аутентификацию перед отправкой любых запросов.
type_filter строка добавлено в community.general 4.2.0	Фильтрация экземпляров по типу `virtual-machine`, `container` или `both`. Первая версия инвентаризации поддерживала только контейнеры. Варианты: `"virtual-machine"` `"container"` ← (по умолчанию) `"both"`
url строка	Путь к сокету unix-домена или URL https для сервера lxd. Сокеты в файловой системе должны начинаться с `unix:`. В основном `unix:/var/lib/lxd/unix.socket` или `unix:/var/snap/lxd/common/lxd/unix.socket`. По умолчанию: `"unix:/var/snap/lxd/common/lxd/unix.socket"`

Примеры

# simple lxd.yml
plugin: community.general.lxd
url: unix:/var/snap/lxd/common/lxd/unix.socket

# simple lxd.yml including filter
plugin: community.general.lxd
url: unix:/var/snap/lxd/common/lxd/unix.socket
state: RUNNING

# simple lxd.yml including virtual machines and containers
plugin: community.general.lxd
url: unix:/var/snap/lxd/common/lxd/unix.socket
type_filter: both

# grouping lxd.yml
groupby:
  locationBerlin:
    type: location
    attribute: Berlin
  netRangeIPv4:
    type: network_range
    attribute: 10.98.143.0/24
  netRangeIPv6:
    type: network_range
    attribute: fd42:bd00:7b11:2167:216:3eff::/24
  osUbuntu:
    type: os
    attribute: ubuntu
  testpattern:
    type: pattern
    attribute: test
  profileDefault:
    type: profile
    attribute: default
  profileX11:
    type: profile
    attribute: x11
  releaseFocal:
    type: release
    attribute: focal
  releaseBionic:
    type: release
    attribute: bionic
  typeVM:
    type: type
    attribute: virtual-machine
  typeContainer:
    type: type
    attribute: container
  vlan666:
    type: vlanid
    attribute: 666
  projectInternals:
    type: project
    attribute: internals

Авторы

Frank Dornheim (@conloos)

Подсказка

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

Ссылки на сборку

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