Skip to content

Repository files navigation

Ansible-Molecule Proxmox-VE Driver

Lint Check Docs

This repository holds an Ansible-Molecule driver for Proxmox-VE.

It enables you to dynamically create VM's on latest Proxmox-VE nodes and target them with integration-tests.


Install

PyPi

First, you have to install these ansible-collections:

ansible-galaxy collection install community.proxmox>=2.0.0
ansible-galaxy collection install oxlorg.molecule_pve

# or
ansible-galaxy collection install git+https://github.com/ansible-collections/community.proxmox.git,2.0.0
ansible-galaxy collection install git+https://github.com/O-X-L/ansible-molecule-pve-utils.git

Then you can install the molecule driver itself:

pip install --upgrade molecule-pve

# or
pip install --upgrade git+https://github.com/O-X-L/ansible-molecule-pve

Documentation

Docs Uptime

See: ansible-molecule-pve.oxl.app


Contribute

You are welcome to report issues/bugs and/or supply patches/features drafts.

When contributing via PR's, please mention if/how you used AI and if so - how you reviewed/tested those auto-generated changes.


Authors / Credits

This is a fork of the molecule-proxmox module, which was originally created by Michael Meffie.

It was modified and enhanced by Pascal Rath.

We decided to create this fork, as the original module is not in a functional state with current default ansible-installations.

So we refactored it to make it work with the currently supported community.proxmox Ansible-collection.

We also implemented some enhancements:

  • async/parallel creation/start/destroy of Test-VMs to speed-up execution
  • support form platform-specific /etc/hosts entries
  • some config-sanity checks

AI Usage

AI is used to speed-up development. All changes are reviewed, logically evaluated and tested manually.