libguestfs Collection

NOTE: This collection is not endorsed by the libguestfs community, this is a personal effort.

libguestfs modules allow users to use Ansible to automate commonly used libguestfs actions in a native way.

Prerequisites

On Ansible Controller:

• Ansible >= 2.8.0 (May work on earlier releases)
• Python >= 2.7.5 || Python >= 3.4
• gcc

On Ansible Host:

• gcc
• libguestfs
• libguestfs-devel
• Python >= 2.7.5 || Python >= 3.4
• libguestfs python bindings:
  • System: If your distribution's package manager contains python-libguestfs, install it (via yum, apt ...)
  • pip: If a virtual environment is used or you do not have a pre packaged python-libguestfs, refer to guestfs python bindings in a virtualenv In order to install via pip download the relevant version from http://download.libguestfs.org/python/ Example, https://download.libguestfs.org/python/guestfs-1.40.2.tar.gz

Compatibility Matrix

Distro	Supported	Notes
Fedora/CentOS/RHEL	Yes
Ubuntu/Debian	Yes
Windows	No	Not Supported, no plans to support right now

Documentation

Please refer to docs directory.

Installation

Ansible Galaxy

Collection can be installed from Ansible galaxy:

ansible-galaxy collection install vkhitrin.libguestfs

Locally

Build the collection:

ansible-galaxy collection build

Install collection:

ansible-galaxy collection install --force vkhitrin-libguestfs-<VERSION>.tar.gz

License

This project is licensed under GPL-3.0 License. Please see the COPYING.md for more information.