Development guide

| Important | | The GitHub repository exist only because Ansible Galaxy support only GitHub. | Please, do your merge requests on Gitlab.

Requirements

Install and configure :

If You are new with Molecule + Vagrant-libvirt, please read this blog post.

Some tests use a web proxy, if you don't have one, install Squid locally with at least :

Quick tests of the role without any options, ran in containers as ansible user :

molecule test -s containers

The driver preference is defined by MOLECULE_CONTAINERS_BACKEND=podman,docker and you can easily switch between the two by setting this variable.

Test the role with its defaults values in a VM of each supported distro :

molecule test

Test the server profile with hosts, users and groups settings customized, ran in vagrant/libvirt VMs as vagrant user :

molecule test -s servers

Test stream distros in vagrant/libvirt VMs as vagrant user :

molecule test -s stream

Test each time synchronization service :

molecule test -s chrony
molecule test -s ntp
molecule test -s systemd-timesyncd

molecule create
molecule converge
molecule login -h <instance_name>
# Do your changes by hand
molecule verify

Merge request in Gitlab.