Molecule EC2 Plugin
Molecule EC2 is designed to allow use of AWS EC2 for provisioning of test resources.
Quickstart
Installation
pip install molecule-ec2Create a scenario
With a new role
molecule init role -d ec2 my-roleThis will create a new folder my-role containing a bare-bone generated
role like you would do with ansible-galaxy init command.
It will also contain a molecule folder with a default scenario
using the ec2 driver (using ansible community.aws.ec2_instance collection).
Install the collection using
ansible-galaxy install -r test_requirements.yml.
In a pre-existing role
molecule init scenario -d ec2This will create a default scenario with the ec2 driver in a molecule folder, located in the current working directory.
Example
This is a molecule.yml example file
dependency:
name: galaxy
driver:
name: ec2
platforms:
- name: instance
image_owner: "099720109477"
image_name: ubuntu/images/hvm-ssd/ubuntu-bionic-18.04-amd64-server-*
instance_type: t2.micro
vpc_subnet_id: <your-aws-vpc-subnet-id>
tags:
Name: molecule_instance
provisioner:
name: ansible
verifier:
name: ansibleAll you need to do is fill in the subnet-id you want to create your test instance into. Then run
molecule testNote
To make this work, you need to export your AWS credentials, as well as the AWS region you want to use, in your environment.
export AWS_ACCESS_KEY_ID=ACCESS_API_KEY
export AWS_SECRET_KEY=SECRET_API_KEY
export AWS_REGION=us-east-1You can read more about managing AWS credentials with Ansible modules in the official documentation of the Ansible AWS modules
Documentation
Details on the parameters for the platforms section are detailed in platforms.rst.
Read the molecule documentation and more at https://molecule.readthedocs.io/.
Get Involved
- Join us in the
#ansible-moleculechannel on Freenode. - Join the discussion in molecule-users Forum.
- Join the community working group by checking the wiki.
- Want to know about releases, subscribe to ansible-announce list.
- For the full list of Ansible email Lists, IRC channels see the communication page.
Authors
Molecule EC2 Plugin was created by Sorin Sbarnea based on code from Molecule.
License
The MIT License.
The logo is licensed under the Creative Commons NoDerivatives 4.0 License.
If you have some other use in mind, contact us.