Ansible

Ansible inside Docker for consistent running of ansible inside your local machine or CI/CD system. You can view CHANGELOG to understand what changes have happened to this recently.

Current Ansible Core Versions

These are the latest Ansible Core versions running within the containers:

• Ansible 2.13: 2.13.13
• Ansible 2.14: 2.14.14
• Ansible 2.15: 2.15.9
• Ansible 2.16: 2.16.4
• Ansible 2.17: 2.17.4
• Older versions are provided within the unmaintained section, including 2.9, 2.10, 2.11 and 2.12.
• More availablity on Ansible versions on Ansible Release Documentation and Ansible-core to Python compatibility.

Supported tags and respective Dockerfile links

Immutable Images

There are a number of immutable images that are also being collected. To find a specific version of Ansible, look within the Docker Hub Tags. Each of the containers follow a similar pattern: Ansible-version-Base OS version.

Ansible Core (2.13, 2.14, 2.15, 2.16, 2.17)

This includes:

• ansible-core (https://pypi.org/project/ansible-core/)
• ansible (https://pypi.org/project/ansible/)
• ansible-lint (https://pypi.org/project/ansible-lint/)

Base Image (↓) \ Ansible Version (→)	Dockerfile	2.13	2.14	2.15	2.16	2.17
Latest	Dockerfile					latest
Alpine	Dockerfile					alpine
Ubuntu	Dockerfile					ubuntu
Alpine 3.16	Dockerfile	2.13-alpine-3.16	2.14-alpine-3.16	2.15-alpine-3.16	2.16-alpine-3.16	2.17-alpine-3.16
Alpine 3.17	Dockerfile	2.13-alpine-3.17	2.14-alpine-3.17	2.15-alpine-3.17	2.16-alpine-3.17	2.17-alpine-3.17
Alpine 3.18	Dockerfile	2.13-alpine-3.18	2.14-alpine-3.18	2.15-alpine-3.18	2.16-alpine-3.18	2.17-alpine-3.18
Alpine 3.19	Dockerfile	2.13-alpine-3.19	2.14-alpine-3.19	2.15-alpine-3.19	2.16-alpine-3.19	2.17-alpine-3.19
Alpine 3.20 (* in development)	Dockerfile			2.15-alpine-3.20*	2.16-alpine-3.20*	2.17-alpine-3.20*
Bullseye (Debian 11)	Dockerfile		2.14-bullseye	2.15-bullseye
Bullseye Slim (Debian 11)	Dockerfile		2.14-bullseye-slim	2.15-bullseye-slim
Bookworm (Debian 12)	Dockerfile		2.14-bookworm	2.15-bookworm	2.16-bookworm	2.17-bookworm
Bookworm Slim (Debian 12)	Dockerfile		2.14-bookworm-slim	2.15-bookworm-slim	2.16-bookworm-slim	2.17-bookworm-slim
Rocky Linux 9	Dockerfile		2.14-rockylinux-9	2.15-rockylinux-9
Ubuntu 22.04	Dockerfile		2.14-ubuntu-22.04	2.15-ubuntu-22.04	2.16-ubuntu-22.04	2.17-ubuntu-22.04
Ubuntu 24.04	Dockerfile			2.15-ubuntu-24.04	2.16-ubuntu-24.04	2.17-ubuntu-24.04

ARM Releases

There is some support for Arm architecture.

• linux/arm64 (Macbook and AWS Graviton) to latest and alpine image tags.
• linux/arm/v7 and linux/arm/v6 to arm image tag (Raspberry Pi). *Experimental!!

Older releases

• Ansible 2.12 (2.12.10) includes ansible-core + ansible. This also requires Python >=3.8
• Ansible 2.11 (2.11.12) includes ansible-core + ansible. This also requires Python 3.
• Ansible 2.10 (2.10.17) includes ansible-base.
• Ansible 2.9 (2.9.27) includes ansible.
• All versions also include ansible-lint.

These are no longer updated or maintained, however, remain for users running older workloads.

Base Image (↓) \ Ansible Version (→)	Dockerfile	2.13	2.14	2.15	2.16	2.17
Alpine 3.15	Dockerfile	2.13-alpine-3.15	2.14-alpine-3.15	2.15-alpine-3.15

Base Image (↓) \ Ansible Version (→)	2.12	2.11	2.10	2.9
Alpine 3.14	2.12-alpine-3.14 Dockerfile	2.11-alpine-3.14 Dockerfile	2.10-alpine-3.14 Dockerfile	2.9-alpine-3.14 Dockerfile
Alpine 3.15	2.12-alpine-3.15 Dockerfile	2.11-alpine-3.15 Dockerfile	2.10-alpine-3.15 Dockerfile	2.9-alpine-3.15 Dockerfile
Alpine 3.16	2.12-alpine-3.16 Dockerfile	2.11-alpine-3.16 Dockerfile	2.10-alpine-3.16 Dockerfile	2.9-alpine-3.16 Dockerfile
Alpine 3.17	2.12-alpine-3.17 Dockerfile	2.11-alpine-3.17 Dockerfile	2.10-alpine-3.17 Dockerfile	2.9-alpine-3.17 Dockerfile
Bullseye (Debian 11)	2.12-bullseye Dockerfile	2.11-bullseye Dockerfile	2.10-bullseye Dockerfile	2.9-bullseye Dockerfile
Bullseye Slim (Debian 11)	2.12-bullseye-slim Dockerfile	2.11-bullseye-slim Dockerfile	2.10-bullseye-slim Dockerfile	2.9-bullseye-slim Dockerfile
Buster (Debian 10)	2.12-buster Dockerfile	2.11-buster Dockerfile	2.10-buster Dockerfile	2.9-buster Dockerfile
Buster Slim (Debian 10)	2.12-buster-slim Dockerfile	2.11-buster-slim Dockerfile	2.10-buster-slim Dockerfile	2.9-buster-slim Dockerfile
Centos 7	2.12-centos-7 Dockerfile	2.11-centos-7 Dockerfile	2.10-centos-7 Dockerfile	2.9-centos-7 Dockerfile
Rocky Linux 8	2.12-rockylinux-8 Dockerfile	2.11-rockylinux-8 Dockerfile	2.10-rockylinux-8 Dockerfile	2.9-rockylinux-8 Dockerfile
Rocky Linux 9	2.12-rockylinux-9 Dockerfile	2.11-rockylinux-9 Dockerfile	2.10-rockylinux-9 Dockerfile	2.9-rockylinux-9 Dockerfile
Ubuntu 18.04	2.12-ubuntu-18.04 Dockerfile	2.11-ubuntu-18.04 Dockerfile	2.10-ubuntu-18.04 Dockerfile	2.9-ubuntu-18.04 Dockerfile
Ubuntu 20.04	2.12-ubuntu-20.04 Dockerfile	2.11-ubuntu-20.04 Dockerfile	2.10-ubuntu-20.04 Dockerfile	2.9-ubuntu-20.04 Dockerfile
Ubuntu 22.04	2.12-ubuntu-22.04 Dockerfile	2.11-ubuntu-22.04 Dockerfile	2.10-ubuntu-22.04 Dockerfile	2.9-ubuntu-22.04 Dockerfile

Using Mitogen

All installs include Mitogen 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:

Please investigate in your container the location of ansible_mitogen (it is different per container). You can do this via:

your_container="ansible:latest"
docker run --rm -it "willhallonline/${your_container}" /bin/sh -c "find / -type d | grep 'ansible_mitogen/plugins' | sort | head -n 1"

and then configuring your own ansible.cfg like:

[defaults]
strategy_plugins = /usr/local/lib/python3.{python-version}/site-packages/ansible_mitogen/plugins/
strategy = mitogen_linear

Running

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

Simple

$~   docker run --rm -it willhallonline/ansible:latest /bin/sh

Mount local directory and ssh key

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

Injecting commands

$~  docker run --rm -it -v $(pwd):/ansible -v ~/.ssh/id_rsa:/root/id_rsa willhallonline/ansible:latest 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:latest /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:latest '

use with:

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

Maintainer

• Written and maintained by Will Hall