https://github.com/vkhitrin/ansible-libguestfs-collection
Ansible collection for libguestfs modules
https://github.com/vkhitrin/ansible-libguestfs-collection
ansible ansible-modules guest-image libguestfs virt-customize
Last synced: 5 months ago
JSON representation
Ansible collection for libguestfs modules
- Host: GitHub
- URL: https://github.com/vkhitrin/ansible-libguestfs-collection
- Owner: vkhitrin
- License: gpl-3.0
- Created: 2022-04-04T19:26:47.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-06-23T18:58:36.000Z (almost 2 years ago)
- Last Synced: 2024-06-23T19:59:12.642Z (almost 2 years ago)
- Topics: ansible, ansible-modules, guest-image, libguestfs, virt-customize
- Language: Python
- Homepage: https://galaxy.ansible.com/vkhitrin/libguestfs
- Size: 39.1 KB
- Stars: 7
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING.md
Awesome Lists containing this project
README
# 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-.tar.gz
```
## License
This project is licensed under GPL-3.0 License. Please see the [COPYING.md](/COPYING.md) for more information.