This repository provides a Cookiecutter template for creating an Ansible role that follows best practices and conventions, and is ready for testing with Molecule. The template sets up a directory structure, and testing framework that allows for easy development, testing, and deployment of Ansible roles. The goal is to speed up the role creation process and make it easy to test and maintain your ansible role.
You can change the role and scenario name to match your desired role name.
- Install Cookiecutter
note
cookiecutteris bundled with ansible molecule.
-
Clone the repository
git clone https://github.com/<your_username>/molecule-template-role.git -
Run Cookiecutter to create the role
$ cookiecutter molecule-template-role # this repo
You have downloaded /<home_directory>/.cookiecutters/molecule before. Is it okay to delete and re-download it?
[yes]: yes
role_name [OVERRIDEN]: <role_name example: role_example_name>
scenario_name [default]: <enter>- After the process is completed navigate to the created directory and start using the role, and customize it to fit your needs
- If you would like to use molecule to test the role please refer to molecule documentation