Skip to main content

Molecule aids in the development and testing of Ansible roles.

Project description

PyPI Package Documentation Status 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 [1] that Ansible supports.

[1]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.

Quick Start



Creating a new role

Creating a new role

Testing a new role

Testing a new role

Testing an existing role

Testing an existing role

Docker in Docker

Testing an existing role



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

Ansible Support

Molecule requires Ansible version 2.2 or later.



The logo is licensed under the Creative Commons NoDerivatives 4.0 License. If you have some other use in mind, contact us.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for molecule, version 2.12.1
Filename, size File type Python version Upload date Hashes
Filename, size molecule-2.12.1-py2-none-any.whl (166.0 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size molecule-2.12.1.tar.gz (4.5 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page