Инвентаризация community.general.lxd — получение инвентаризации Ansible с хоста lxd

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 path	Путь к файлу сертификата клиента. По умолчанию: `"$HOME/.config/lxc/client.crt"`
client_key псевдонимы: key_file path	Путь к файлу ключа сертификата клиента. По умолчанию: `"$HOME/.config/lxc/client.key"`
groupby dictionary	Создаёт группы по следующим ключевым словам: `location`, `network_range`, `os`, `pattern`, `profile`, `release`, `type`, `vlanid`. Синтаксис см. в примере.
plugin string / обязательный	Токен, который указывает, что этот файл является файлом источника для плагина «lxd». Допустимые значения: `"community.general.lxd"`
prefered_instance_network_family string	Если у экземпляра несколько сетевых интерфейсов, указывает, какой из них предпочтителен для данного семейства адресов. Укажите `inet` для IPv4 и `inet6` для IPv6. Допустимые значения: `"inet"` ← (по умолчанию) `"inet6"`
prefered_instance_network_interface псевдонимы: prefered_container_network_interface string	Если у экземпляра несколько сетевых интерфейсов, указывает шаблон для выбора предпочтительного интерфейса. Используется в сочетании с первым найденным числом, например `eth` + `0`. В community.general 3.8.0 параметр переименован из `prefered_container_network_interface` в `prefered_instance_network_interface`. Прежнее имя по-прежнему работает как псевдоним. По умолчанию: `"eth"`
project string добавлено в community.general 6.2.0	Фильтрует экземпляры по указанному проекту. По умолчанию: `"default"`
server_cert path добавлено в community.general 8.0.0	Путь к файлу сертификата сервера.
server_check_hostname boolean добавлено в community.general 8.0.0	Этот параметр определяет, проверяется ли имя хоста сервера при проверке HTTPS-соединения. Проверку можно отключить, если, например, предоставленный сертификат сервера (см. параметр `server_cert`) не соответствует имени, используемому для связи с сервером. Такое несоответствие встречается часто, поскольку LXD по умолчанию создаёт самоподписанные сертификаты сервера. Допустимые значения: `false` `true` ← (по умолчанию)
state string	Фильтрует экземпляры по текущему состоянию. Допустимые значения: `"STOPPED"` `"STARTING"` `"RUNNING"` `"none"` ← (по умолчанию)
trust_password string	Пароль доверия клиента. Перед запуском этого модуля необходимо задать этот пароль на сервере 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 string добавлено в community.general 4.2.0	Фильтрует экземпляры по типу: `virtual-machine`, `container` или `both`. Первая версия инвентаризации поддерживала только контейнеры. Допустимые значения: `"virtual-machine"` `"container"` ← (по умолчанию) `"both"`
url string	Путь к сокету домена 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/lxd_inventory.html