Skip to content

Molecule aids in the development and testing of Ansible roles.

License

Notifications You must be signed in to change notification settings

3JIou-home/molecule

 
 

Repository files navigation

Molecule

PyPI Package Documentation Status https://img.shields.io/travis/com/ansible/molecule/master.svg?label=Linux%20builds%20%40%20Travis%20CI Ansible Code of Conduct Ansible mailing lists 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

Installing

Installing

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

Documentation

https://molecule.readthedocs.io/

Contact

Ansible Support

Molecule requires Ansible version 2.4 or later.

License

MIT

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

Authors

Molecule was created by Retr0h and is now maintained as part of the Ansible by Red Hat project.

About

Molecule aids in the development and testing of Ansible roles.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 99.9%
  • Other 0.1%