W3cubDocs

/Ansible

community.libvirt.libvirt_lxc connection – Run tasks in lxc containers via libvirt

Note

This connection plugin is part of the community.libvirt collection (version 1.4.0).

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.libvirt.

To use it in a playbook, specify: community.libvirt.libvirt_lxc.

Synopsis

  • Run commands or put/fetch files to an existing lxc container using libvirt.

Parameters

Parameter

Comments

libvirt_lxc_noseclabel

boolean

added in community.libvirt 1.4.0

This setting causes libvirt to connect to LXC containers by passing ``–noseclabel`` parameter to ``virsh`` command.

This is necessary when running on systems which do not have SELinux.

Choices:

  • false ← (default)
  • true

Configuration:

remote_addr

string

Container identifier.

Default: "The set user as per docker's configuration"

Configuration:

  • Variable: ansible_host
  • Variable: ansible_libvirt_lxc_host

Note

Configuration entries listed above for each entry type (Ansible variable, environment variable, and so on) have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up. The entry types are also ordered by precedence from low to high priority order. For example, an ansible.cfg entry (further up in the list) is overwritten by an Ansible variable (further down in the list).

Authors

  • Michael Scherer (@mscherer)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/libvirt/libvirt_lxc_connection.html