community.general.lxd – Returns Ansible inventory from lxd host

Note

This plugin is part of the community.general collection (version 3.8.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.lxd.

New in version 3.0.0: of community.general

Synopsis

  • Get inventory from the lxd.

  • Uses a YAML configuration file that ends with ‘lxd.(yml|yaml)’.

Parameters

Parameter

Comments

client_cert

aliases: cert_file

path

The client certificate file path.

Default: “$HOME/.config/lxc/client.crt”

client_key

aliases: key_file

path

The client certificate key file path.

Default: “$HOME/.config/lxc/client.key”

groupby

dictionary

Create groups by the following keywords location, pattern, network_range, os, release, profile, vlanid.

See example for syntax.

plugin

string / required

Token that ensures this is a source file for the ‘lxd’ plugin.

Choices:

  • community.general.lxd

prefered_container_network_family

string

If a container has multiple network interfaces, which one is the prefered by family.

Specify inet for IPv4 and inet6 for IPv6.

Choices:

  • inet ← (default)

  • inet6

prefered_container_network_interface

string

If a container has multiple network interfaces, select which one is the prefered as pattern.

Combined with the first number that can be found e.g. ‘eth’ + 0.

Default: “eth”

state

string

Filter the container according to the current status.

Choices:

  • STOPPED

  • STARTING

  • RUNNING

  • none ← (default)

trust_password

string

The client trusted password.

You need to set this password on the lxd server before running this module using the following command lxc config set core.trust_password <some random password> See https://www.stgraber.org/2016/04/18/lxd-api-direct-interaction/.

If trust_password is set, this module send a request for authentication before sending any requests.

url

string

The unix domain socket path or the https URL for the lxd server.

Sockets in filesystem have to start with unix:.

Mostly unix:/var/lib/lxd/unix.socket or unix:/var/snap/lxd/common/lxd/unix.socket.

Default: “unix:/var/snap/lxd/common/lxd/unix.socket”

Examples

# 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

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

Authors

  • Frank Dornheim (@conloos)