Ansible inside Docker for consistent running of Ansible inside your local machine or CI/CD system.

Docker Pulls Docker Automated build Docker Build Status

Ansible 2.7

  • latest, 2.7, alpine, 2.7-alpine, alpine-3, 2.7-alpine-3, alpine-3.8, 2.7-alpine-3.8 Dockerfile MicroBadger Layers
  • alpine-3.7, 2.7-alpine-3.7 Dockerfile
  • alpine-3.6, 2.7-alpine-3.6 Dockerfile
  • ubuntu, 2.7-ubuntu, ubuntu-18.04, 2.7-ubuntu-18.04 Dockerfile MicroBadger Layers
  • ubuntu-16.04, 2.7-ubuntu-16.04 Dockerfile
  • centos, centos-7, 2.7-centos, 2.7-centos-7 Dockerfile MicroBadger Layers

Ansible 2.5 (with Mitogen)

This is my preferred install variant mainly due to the performance improvements that Mitogen awards you. You can read more about it inside the Mitogen for Ansible documentation.

To leverage Mitogen to accelerate your playbook runs, add this to your ansible.cfg:

strategy_plugins = /usr/lib/python2.7/site-packages/ansible_mitogen/plugins/strategy
strategy = mitogen_linear


**You will likely need to mount required directories into your container to make it run (or build on top of what is here).


$   docker run --rm -it willhallonline/ansible /bin/sh

Mount local directory and ssh key

$   docker run --rm -it -v $(pwd):/ansible -v ~/.ssh/id_rsa:/root/id_rsa willhallonline/ansible:2.5 /bin/sh

Injecting commands

$   docker run --rm -it -v $(pwd):/ansible -v ~/.ssh/id_rsa:/root/id_rsa willhallonline/ansible:2.5 ansible-playbook playbook.yml

Bash Alias

You can put these inside your dotfiles (~/.bashrc or ~/.zshrc to make handy aliases).

alias docker-ansible-cli='docker run --rm -it -v $(pwd):/ansible -v ~/.ssh/id_rsa:/root/.ssh/id_rsa --workdir=/ansible willhallonline/ansible:2.5-alpine /bin/sh'
alias docker-ansible-cmd='docker run --rm -it -v $(pwd):/ansible -v ~/.ssh/id_rsa:/root/.ssh/id_rsa --workdir=/ansible willhallonline/ansible:2.5-alpine '

use with:

$  docker-ansible-cli ansible-playbook -u playbook.yml