Skip to main content
********
Molecule
********

.. image:: https://badge.fury.io/py/molecule.svg
:target: https://badge.fury.io/py/molecule
:alt: PyPI Package

.. image:: https://readthedocs.org/projects/molecule/badge/?version=latest
:target: https://molecule.readthedocs.io/en/latest/
:alt: Documentation Status

.. image:: https://img.shields.io/badge/license-MIT-brightgreen.svg
:target: LICENSE
:alt: Repository License

Molecule 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 is opinionated in order to encourage an approach
that results in consistently developed roles that are well-written, easily
understood and maintained.

Molecule uses `Ansible`_ `playbooks`_ to exercise the `role`_ and its
associated tests. Molecule supports any provider [#]_ that `Ansible`_
supports.

.. [#]

Providers can be bare-metal, virtual, cloud or containers. If Ansible can
use it, Molecule can test it. Molecule simply leverages Ansible's module
system to manage instances.

.. _`playbooks`: https://docs.ansible.com/ansible/playbooks.html
.. _`role`: http://docs.ansible.com/ansible/playbooks_roles.html

Quick Start
===========

Installing
----------

.. image:: https://asciinema.org/a/161970.png
:target: https://asciinema.org/a/161970?speed=5&autoplay=1&loop=1
:alt: Installing

Creating a new role
-------------------

.. image:: https://asciinema.org/a/161976.png
:target: https://asciinema.org/a/161976?speed=5&autoplay=1&loop=1
:alt: Creating a new role

Testing a new role
-------------------

.. image:: https://asciinema.org/a/161977.png
:target: https://asciinema.org/a/161977?speed=5&autoplay=1&loop=1
:alt: Testing a new role

Testing an existing role
-------------------

.. image:: https://asciinema.org/a/AkQ4KhxuGAxwn1YJX3tM5BZld.png
:target: https://asciinema.org/a/AkQ4KhxuGAxwn1YJX3tM5BZld?speed=5&autoplay=1&loop=1
:alt: Testing an existing role

Documentation
=============

https://molecule.readthedocs.io/

Contact
=======

IRC
---

Join us in the #molecule-users channel on `freenode`_.

.. _`freenode`: https://freenode.net

Forums
------

* `molecule-users`_
* `molecule-dev`_

.. _`molecule-users`: https://groups.google.com/forum/#!forum/molecule-users
.. _`molecule-dev`: https://groups.google.com/forum/#!forum/molecule-dev

Ansible Support
===============

Molecule requires Ansible version 2.2 or later.

.. _`Ansible`: https://docs.ansible.com

License
=======

`MIT`_

.. _`MIT`: https://github.com/metacloud/molecule/blob/master/LICENSE

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`: https://creativecommons.org/licenses/by-nd/4.0/



Release files for molecule 2.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for molecule 2.10.1
File Size Uploaded
molecule-2.10.1.tar.gz 4.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for molecule 2.10.1
File Interpreter ABI Platform
molecule-2.10.1-py2-none-any.whl Python 2 none any Details

Total release size: 4.7 MB

Release files / molecule-2.10.1.tar.gz

Download URL molecule-2.10.1.tar.gz
Size 4.5 MB
Tags Source
SHA-256 checksum
How to use checksums
7f7d21e396f4492c6d11f6b5ad99b0abed7682ff3583f7f768912d2e4f0d0244
BLAKE2b-256 checksum
How to use checksums
940d01d5b5d30ee880111e065e367939c0a1c48bcd0e4f248c104157b00533af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / molecule-2.10.1-py2-none-any.whl

Download URL molecule-2.10.1-py2-none-any.whl
Size 168.0 kB
Tags Python 2
SHA-256 checksum
How to use checksums
5065166e3f055cc80bbd1c9366f2a1606ab5ae4adf54b7510be57e51228e8d7f
BLAKE2b-256 checksum
How to use checksums
90fbf0dfe3fa4f81fea78bbc5c945a686ee2b3a293af11620dafb160fbac35fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

26.8.0

2 release files

26.6.0

2 release files

26.2.0

2 release files

25.9.0

2 release files

25.7.0

2 release files

25.6.0

2 release files

25.5.0

2 release files

25.3.1

2 release files

25.3.0

2 release files

25.2.0

2 release files

25.1.0

2 release files

24.9.0

2 release files

24.8.0

2 release files

24.7.0

2 release files

6.0.3

2 release files

6.0.2

2 release files

6.0.1

2 release files

6.0.0

2 release files

5.1.0

2 release files

5.0.1

2 release files

5.0.0

2 release files

4.0.4

2 release files

4.0.3

2 release files

4.0.2

2 release files

4.0.1

2 release files

4.0.0

2 release files

3.6.1

2 release files

3.6.0

2 release files

3.5.2

2 release files

3.5.1

2 release files

3.4.1

2 release files

3.4.0

2 release files

3.3.4

2 release files

3.3.3

2 release files

3.3.2

2 release files

3.3.1

2 release files

3.3.0

2 release files

3.2.4

2 release files

3.2.3

2 release files

3.2.2

2 release files

3.2.1

2 release files

3.2.0

2 release files

3.1.5

2 release files

3.1.4

2 release files

3.1.3

2 release files

3.1.2

2 release files

3.1.1

2 release files

3.1.0

2 release files

3.0.8

2 release files

3.0.7

2 release files

3.0.6

2 release files

3.0.5

2 release files

3.0.4

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.22

2 release files

2.20.2

2 release files

2.20.1

2 release files

2.20.0

2 release files

2.19.0

3 release files

2.18.1

3 release files

2.18.0

3 release files

2.17.0

3 release files

2.16.0

3 release files

2.14.0

3 release files

2.13.0

3 release files

2.11.0

2 release files

This release

2.10.1 This release

2 release files

1.25.1

2 release files

1.23.0

2 release files

1.22.0

2 release files

1.21.1

2 release files

1.20.3

2 release files

1.20.2

1.20.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page