About Ansible Molecule

Molecule aids in the development and testing of Ansible roles
Under MIT License
By ansible-community

python ansible hacktoberfest docker testing testing-framework testinfra ansible-lint molecule-driver podman cookiecutter-ansible ansible-toolset ansible-devtools

Ansible Molecule

.. image::
:alt: PyPI Package

.. image::
:alt: Documentation Status

.. image::

.. image::
:alt: Python Black Code Style

.. image::
:alt: Ansible Code of Conduct

.. image::
:alt: Discussions

.. image::
:target: LICENSE
:alt: Repository License

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

Once installed, the command line can be called using any of the methods below:

.. code-block:: bash

molecule ...
mol ... # same as above, introduced in 3.0.5
python3 -m molecule ... # python module calling method

.. _Ansible:

.. _documentation:


Read the documentation and more at

.. _get-involved:

Get Involved

If you want to get moving fast and make a quick patch:

.. code-block:: bash

$ git clone && 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!

.. wiki:
ansible-announce list:
.. _communication page:

.. _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.

.. _MIT:

The logo is licensed under the Creative Commons NoDerivatives 4.0 License_.

If you have some other use in mind, contact us.

.. _Creative Commons NoDerivatives 4.0 License: