ansible-libguestfs-collection

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

ansible-libguestfs-collection

★ 9 Open GitHub ↗

Ansible collection for libguestfs modules

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# libguestfs Collection

**NOTE:** This collection is not endorsed by the [libguestfs](https://libguestfs.org)
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](https://www.libguestfs.org/guestfs-python.3.html#using-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](https://listman.redhat.com/archives/libguestfs/2016-February/msg00145.html) |

## Documentation

Please refer to [docs](/docs) directory.

## Installation

### Ansible Galaxy

Collection can be installed from Ansible galaxy:

```shell
ansible-galaxy collection install vkhitrin.libguestfs
```

### Locally

Build the collection:

```shell
ansible-galaxy collection build
```

Install collection:

```shell
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](/COPYING.md) for more information.

ansible-libguestfs-collection

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README