NetflixOSS Aminator Ansible Playbook and AMIs
Aminator is a tool for creating EBS AMIs for AWS. Before running the playbook, there are a few things we need to do:
Launch an EC2 instance for Aminator
- Create an Aminator IAM Role with this policy
- Create an Aminator security group
- Allow port 22 for SSH
If you don't already, create a new Key pair, and add it to your keychain or SSH agent so you don't need to specify it later:
$ ssh-add mykey.pem
Launch a new EC2 instance using the above IAM Role, Security Group and key pair. Use Ubuntu 12.04 LTS as the AMI.
- Set the
Nametag of the instance to
- Confirm you can see the instance using the Ansible EC2 inventory
$ /etc/ansible/hosts | grep 'Aminator'
Run Ansible playbook
Now you can run the playbook
$ ansible-playbook playbooks/aminator-ubuntu.yml -l 'tag_Name_Aminator'
If you are using this playbook, there is a decent chance you want to use the Ansible Provisioner for Aminator as well. Since this has not been merge yet (spam mtripoli and kvick if you want this merged), instead of pulling Aminator from their repo, it pulls from here: https://github.com/pas256/aminator.git. You can modify the file in
roles/aminator/vars/main.yml and change the repo if you like. Aminator is installed to
The playbook also checks out this repo as well, so you can start baking your own AMIs based off these playbooks. You can find it here:
One more thing. If you want to pay it forward, this playbook also installs DistAMI. Now there are no excuses for keeping useful AMIs private.
Once the playbook is finished, you can SSH to the instance an start aminating. Example:
ssh email@example.com sudo aminate -e ec2_ansible_linux -B ami-bb2ab88b aminator-ubuntu.yml
The easy way with CloudFormation
If all of that seems too hard, feel free to use the Aminator CloudFormation template to bring up Aminator in just a few clicks.
You can find the list of pre-built AMIs here:
If you have feedback, comments or suggestions, please feel free to contact Peter at Answers for AWS, create an Issue, or submit a pull request.