rubandeventhiran/ansible-kick

Utility to proxy remote ansible push requests via SSH

Ansible Kick

An alternative to ansible-pull designed to make it easy for ec2 instances to request an Ansible push during initial boot; think auto-scaling.

How it works

• ec2 instance request an Ansible push via a remote SSH forced command during initial boot

ssh -i /tmp/ansible_kick -o RequestTTY=no -o StrictHostKeyChecking=no [email protected]

• Search EC2 for a single instance with a public or private IP address matching the SSH_CLIENT environment variable
• If an EC2 instance is found assign a role based on the value of a instance tag, role by default
• Generate a temporary Ansible inventory file using a template:

[role]
ec2instance

• Locates an Ansible playbook matching the role name (/etc/ansible/playbooks/role.yml)
• Execute ansible-playbook using the temporary inventory file and matching playbook

ansible-playbook -i /path/to/temp-inventory /path/to/role.yml

• Block until the ansible-playbook command exits
• ec2 instance continues booting

Install

go get github.com/kelseyhightower/ansible-kick

Setup and Configuration

docs/setup.md

Build

ansible-kick requires the following dependencies:

• launchpad.net/goamz/aws (bzr)
• launchpad.net/goamz/ec2 (bzr)
• github.com/BurntSushi/toml (git)

Clone this repository into $GOPATH/src/github.com/kelseyhightower/ansible-kick

mkdir -p $GOPATH/src/github.com/kelseyhightower
cd $GOPATH/src/github.com/kelseyhightower
git clone https://github.com/kelseyhightower/ansible-kick.git
cd ansible-kick

Then run:

go get
go build 

You should end-up with a working ansible-kick executable