community.libvirt.libvirt_qemu connection – Run tasks on libvirt/qemu virtual machines
This connection plugin is part of the community.libvirt collection (version 1.2.0).
You might already have this collection installed if you are using the
It is not included in
To check whether it is installed, run
ansible-galaxy collection list.
To install it, use:
ansible-galaxy collection install community.libvirt.
You need further requirements to be able to use this connection plugin,
see Requirements for details.
To use it in a playbook, specify:
New in community.libvirt 2.10.0
Run commands or put/fetch files to libvirt/qemu virtual machines using the qemu agent API.
The below requirements are needed on the local controller node that executes this connection.
python >= 2.6
libvirt python bindings
Shell to use for execution inside container.
Set this to ‘cmd’ or ‘powershell’ for Windows VMs.
Virtual machine name.
Libvirt URI to connect to to access the virtual machine.
Currently DOES NOT work with selinux set to enforcing in the VM.
Requires the qemu-agent installed in the VM.
Requires access to the qemu-ga commands guest-exec, guest-exec-status, guest-file-close, guest-file-open, guest-file-read, guest-file-write.