https://github.com/willhallonline/docker-ansible
Ansible inside Docker containers: Alpine, Ubuntu, Rocky & Debian with Ansible 2.18, 2.17, 2.16, 2.15, 2.14, 2.13 + Mitogen
https://github.com/willhallonline/docker-ansible
alpine ansible configuration-management containers debian devops docker docker-ansible docker-automated docker-image dockerfile rockylinux ubuntu
Last synced: 4 months ago
JSON representation
Ansible inside Docker containers: Alpine, Ubuntu, Rocky & Debian with Ansible 2.18, 2.17, 2.16, 2.15, 2.14, 2.13 + Mitogen
- Host: GitHub
- URL: https://github.com/willhallonline/docker-ansible
- Owner: willhallonline
- License: mit
- Created: 2018-10-10T08:15:48.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2025-06-13T14:09:12.000Z (4 months ago)
- Last Synced: 2025-06-13T15:25:37.474Z (4 months ago)
- Topics: alpine, ansible, configuration-management, containers, debian, devops, docker, docker-ansible, docker-automated, docker-image, dockerfile, rockylinux, ubuntu
- Language: Dockerfile
- Homepage: https://www.willhallonline.co.uk/project/docker/docker-ansible/
- Size: 396 KB
- Stars: 440
- Watchers: 8
- Forks: 147
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Ansible
Ansible inside Docker for consistent running of ansible inside your local machine or CI/CD system. You can view [CHANGELOG](https://github.com/willhallonline/docker-ansible/blob/main/CHANGELOG.md) to understand what changes have happened to this recently.
[][hub] 
## 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.18
- Ansible 2.15: 2.15.13
- Ansible 2.16: 2.16.14
- Ansible 2.17: 2.17.12
- Ansible 2.18: 2.18.6
- 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](https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html) and [Ansible-core to Python compatibility](https://pypi.org/project/ansible-core/#history).
## 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](https://hub.docker.com/r/willhallonline/ansible/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, 2.18)
This includes:
- `ansible-core` ()
- `ansible` ()
- `ansible-lint` ()
| Base Image (↓) \ Ansible Version (→) | Dockerfile | 2.13 | 2.14 | 2.15 | 2.16 | 2.17 | 2.18 |
|--------------------------------------|-------------------------------------------------------------------------------------------------------------------------|--------------------|----------------------|----------------------|----------------------|----------------------|----------------------|
| Latest | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine318/Dockerfile) | | | | | | `latest` |
| Alpine | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine318/Dockerfile) | | | | | | `alpine` |
| Ubuntu | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/ubuntu2204/Dockerfile) | | | | | | `ubuntu` |
| Alpine 3.18 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/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` | `2.18-alpine-3.18` |
| Alpine 3.19 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/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` | `2.18-alpine-3.19` |
| Alpine 3.20 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine-3.20/Dockerfile) | | | | `2.16-alpine-3.20` | `2.17-alpine-3.20` | `2.18-alpine-3.20` |
| Alpine 3.21 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine-3.21/Dockerfile) | | | | `2.16-alpine-3.21` | `2.17-alpine-3.21` | `2.18-alpine-3.21` |
| Alpine 3.22 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine-3.22/Dockerfile) | | | | `2.16-alpine-3.22` | `2.17-alpine-3.22` | `2.18-alpine-3.22` |
| Bullseye (Debian 11) | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bullseye/Dockerfile) | | `2.14-debian-bullseye` | `2.15-debian-bullseye` | | | |
| Bullseye Slim (Debian 11) | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bullseye-slim/Dockerfile) | | `2.14-debian-bullseye-slim` | `2.15-debian-bullseye-slim` | | | |
| Bookworm (Debian 12) | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bookworm/Dockerfile) | | `2.14-debian-bookworm` | `2.15-debian-bookworm` | `2.16-debian-bookworm` | `2.17-debian-bookworm` | `2.18-debian-bookworm` |
| Bookworm Slim (Debian 12) | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bookworm-slim/Dockerfile) | | `2.14-debian-bookworm-slim` | `2.15-debian-bookworm-slim` | `2.16-debian-bookworm-slim` | `2.17-debian-bookworm-slim` | `2.18-debian-bookworm-slim` |
| Rocky Linux 9 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/rocky9/Dockerfile) | `2.13-rockylinux-9` | `2.14-rockylinux-9` | `2.15-rockylinux-9` | | | |
| Ubuntu 20.04 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/ubuntu-20.04/Dockerfile) | | `2.13-ubuntu-20.04` | | | | |
| Ubuntu 22.04 | [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/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](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/ubuntu-24.04/Dockerfile) | | | `2.15-ubuntu-24.04` | `2.16-ubuntu-24.04` | `2.17-ubuntu-24.04` | `2.18-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 | 2.18 |
|--------------------------------------|-------------------------------------------------------------------------------------------------------------------------|--------------------|----------------------|----------------------|----------------------|----------------------|----------------------|
| Alpine 3.15 | Dockerfile | `2.13-alpine-3.15` | `2.14-alpine-3.15` | `2.15-alpine-3.15` | | | |
| 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` | `2.18-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` | `2.18-alpine-3.17` |
| Base Image (↓) \ Ansible Version (→) | 2.12 | 2.11 | 2.10 | 2.9 |
|--------------------------------------|-------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
| Alpine 3.14 | `2.12-alpine-3.14` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/alpine314/Dockerfile) | `2.11-alpine-3.14` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/alpine314/Dockerfile) | `2.10-alpine-3.14` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/alpine314/Dockerfile) | `2.9-alpine-3.14` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/alpine314/Dockerfile) |
| Alpine 3.15 | `2.12-alpine-3.15` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine315/Dockerfile) | `2.11-alpine-3.15` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine315/Dockerfile) | `2.10-alpine-3.15` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/alpine315/Dockerfile) | `2.9-alpine-3.15` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/alpine315/Dockerfile) |
| Alpine 3.16 | `2.12-alpine-3.16` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine316/Dockerfile) | `2.11-alpine-3.16` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine316/Dockerfile) | `2.10-alpine-3.16` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/alpine316/Dockerfile) | `2.9-alpine-3.16` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/alpine316/Dockerfile) |
| Alpine 3.17 | `2.12-alpine-3.17` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine317/Dockerfile) | `2.11-alpine-3.17` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/alpine317/Dockerfile) | `2.10-alpine-3.17` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/alpine317/Dockerfile) | `2.9-alpine-3.17` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/alpine317/Dockerfile) |
| Bullseye (Debian 11) | `2.12-bullseye` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bullseye/Dockerfile) | `2.11-bullseye` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bullseye/Dockerfile) | `2.10-bullseye` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/debian-bullseye/Dockerfile) | `2.9-bullseye` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/debian-bullseye/Dockerfile) |
| Bullseye Slim (Debian 11) | `2.12-bullseye-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bullseye-slim/Dockerfile) | `2.11-bullseye-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-bullseye-slim/Dockerfile) | `2.10-bullseye-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/debian-bullseye-slim/Dockerfile) | `2.9-bullseye-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/debian-bullseye-slim/Dockerfile) |
| Buster (Debian 10) | `2.12-buster` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/debian-buster/Dockerfile) | `2.11-buster` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-buster/Dockerfile) | `2.10-buster` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/debian-buster/Dockerfile) | `2.9-buster` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/debian-buster/Dockerfile) |
| Buster Slim (Debian 10) | `2.12-buster-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/debian-buster-slim/Dockerfile) | `2.11-buster-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/debian-buster-slim/Dockerfile) | `2.10-buster-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/debian-buster-slim/Dockerfile) | `2.9-buster-slim` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/debian-buster-slim/Dockerfile) |
| Centos 7 | `2.12-centos-7` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/centos7/Dockerfile) | `2.11-centos-7` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/centos7/Dockerfile) | `2.10-centos-7` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/centos7/Dockerfile) | `2.9-centos-7` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/centos7/Dockerfile) |
| Rocky Linux 8 | `2.12-rockylinux-8` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/rocky8/Dockerfile) | `2.11-rockylinux-8` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/rocky8/Dockerfile) | `2.10-rockylinux-8` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/rocky8/Dockerfile) | `2.9-rockylinux-8` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/rocky8/Dockerfile) |
| Rocky Linux 9 | `2.12-rockylinux-9` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/rocky9/Dockerfile) | `2.11-rockylinux-9` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/rocky9/Dockerfile) | `2.10-rockylinux-9` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/rocky9/Dockerfile) | `2.9-rockylinux-9` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/rocky9/Dockerfile) |
| Ubuntu 18.04 | `2.12-ubuntu-18.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/ubuntu1804/Dockerfile) | `2.11-ubuntu-18.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/ubuntu1804/Dockerfile) | `2.10-ubuntu-18.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/ubuntu1804/Dockerfile) | `2.9-ubuntu-18.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/ubuntu1804/Dockerfile) |
| Ubuntu 20.04 | `2.12-ubuntu-20.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-core/ubuntu2004/Dockerfile) | `2.11-ubuntu-20.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/ubuntu2004/Dockerfile) | `2.10-ubuntu-20.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/ubuntu2004/Dockerfile) | `2.9-ubuntu-20.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/ubuntu2004/Dockerfile) |
| Ubuntu 22.04 | `2.12-ubuntu-22.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/ubuntu2204/Dockerfile) | `2.11-ubuntu-22.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/ansible-core/ubuntu2204/Dockerfile) | `2.10-ubuntu-22.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible-base/ubuntu2204/Dockerfile) | `2.9-ubuntu-22.04` [Dockerfile](https://github.com/willhallonline/docker-ansible/blob/main/archive/ansible/ubuntu2204/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](https://mitogen.readthedocs.io/en/stable/ansible.html). 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:
```bash
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:
```ini
[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
```bash
docker run --rm -it willhallonline/ansible:latest /bin/sh
```
### Mount local directory and ssh key
```bash
docker run --rm -it -v $(pwd):/ansible -v ~/.ssh/id_rsa:/root/id_rsa willhallonline/ansible:latest /bin/sh
```
### Injecting commands
```bash
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).
```bash
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:
```bash
docker-ansible-cli ansible-playbook -u playbook.yml
```
## Maintainer
- Written and maintained by [Will Hall](https://www.willhallonline.co.uk)
[hub]: https://hub.docker.com/r/willhallonline/ansible