About Ansible Molecule
Molecule project is designed to aid in the development and testing of
Ansible roles.
Molecule provides support for testing with multiple instances, operating
systems and distributions, virtualization providers, test frameworks and
testing scenarios.
Molecule encourages an approach that results in consistently developed
roles that are well-written, easily understood and maintained.
Molecule supports only the latest two major versions of Ansible (N/N-1),
meaning that if the latest version is 2.9.x, we will also test our code
with 2.8.x.
Once installed, the command line can be called using any of the methods
below:
molecule ...
python3 -m molecule ... # python module calling method
Documentation
Read the documentation and more at https://molecule.readthedocs.io/.
Get Involved
- Join us in the
#ansible-devtoolsirc channel on
libera.chat. - Check github
discussions. - Join the community working group by checking the
wiki. - Want to know about releases, subscribe to ansible-announce
list. - For the full list of Ansible email Lists, IRC channels see the
communication
page.
If you want to get moving fast and make a quick patch:
$ git clone https://github.com/ansible-community/molecule && cd molecule
$ python3 -m venv .venv && source .venv/bin/activate
$ python3 -m pip install -U setuptools pip tox
And you're ready to make your changes!
Authors
Molecule project was created by Retr0h and
it is now community-maintained as part of the
Ansible by Red Hat project.
License
The
MIT
License.
The logo is licensed under the Creative Commons NoDerivatives 4.0
License.
If you have some other use in mind, contact us.