Supported tags¶
This page is the reference matrix for supported willhallonline/ansible tags.
Moving tags use the core stream and operating system:
For example, 2.21-alpine-3.24 means Ansible core 2.21 on Alpine Linux 3.24.
Full patch tags such as 2.21.4-alpine-3.24 are also published when you need
the exact core patch release.
Use this table for automation
Pick one tag from the matrix and use it consistently in Dockerfiles, CI
jobs, and scheduled automation. Avoid relying on latest unless you are
intentionally tracking the default image.
Current Ansible core versions¶
| Ansible minor | Current ansible-core version |
|---|---|
| 2.21 | 2.21.4 |
| 2.20 | 2.20.9 |
| 2.19 | 2.19.13 |
| 2.18 | 2.18.19 |
Convenience tags¶
| Tag | Current target | Use case |
|---|---|---|
latest |
2.21-alpine-3.24 |
Quick tests and default pulls |
alpine |
2.21-alpine-3.24 |
Latest supported Alpine image |
ubuntu |
2.21-ubuntu-24.04 |
Latest supported Ubuntu image |
Convenience tags move
Convenience tags can change target as the project advances. Use matrix tags or fully pinned tags when repeatability matters.
Platform availability
Current builds generally target linux/amd64 and linux/arm64, but each
tag has its own manifest. 2.21-ubuntu-24.04 is AMD64-only, and no ARMv7
or other 32-bit ARM builds are published.
Retired Alpine bases
Alpine 3.19 is archived and Alpine 3.20 is deprecated upstream. They are intentionally omitted from the current matrix; use Alpine 3.21 through 3.24.
Systemd test-image tags¶
The separate willhallonline/ansible-test image family adds systemd for
service-management tests. Its active tag matrix is maintained by
willhallonline/docker-ansible-test:
| Base image | Active Ansible streams |
|---|---|
| Debian Bookworm and Bookworm Slim | 2.18, 2.19 |
| Debian Trixie and Trixie Slim | 2.18, 2.19, 2.20, 2.21 |
| Rocky Linux 10 | 2.18, 2.19, 2.20, 2.21 |
| Ubuntu 24.04 | 2.18, 2.19, 2.20, 2.21 |
| Ubuntu 26.04 | 2.20, 2.21 |
Only 2.21-debian-trixie also receives the latest alias. Alpine is
intentionally excluded because it uses OpenRC rather than systemd. Ubuntu
24.04 test images are AMD64-only; other current test builds publish AMD64 and
ARM64, with no ARMv7 variants. Retained historical registry tags are not part
of the active support matrix. See Docker Ansible Test
for cgroup requirements and systemd examples.
Full supported tag matrix¶
| Base image | 2.21 | 2.20 | 2.19 | 2.18 |
|---|---|---|---|---|
| Alpine 3.21 | 2.21-alpine-3.21 |
2.20-alpine-3.21 |
2.19-alpine-3.21 |
2.18-alpine-3.21 |
| Alpine 3.22 | 2.21-alpine-3.22 |
2.20-alpine-3.22 |
2.19-alpine-3.22 |
2.18-alpine-3.22 |
| Alpine 3.23 | 2.21-alpine-3.23 |
2.20-alpine-3.23 |
2.19-alpine-3.23 |
2.18-alpine-3.23 |
| Alpine 3.24 | 2.21-alpine-3.24 |
2.20-alpine-3.24 |
2.19-alpine-3.24 |
2.18-alpine-3.24 |
| Debian Bookworm | — | — | 2.19-debian-bookworm |
2.18-debian-bookworm |
| Debian Bookworm Slim | — | — | 2.19-debian-bookworm-slim |
2.18-debian-bookworm-slim |
| Debian Trixie | 2.21-debian-trixie |
2.20-debian-trixie |
2.19-debian-trixie |
2.18-debian-trixie |
| Debian Trixie Slim | 2.21-debian-trixie-slim |
2.20-debian-trixie-slim |
2.19-debian-trixie-slim |
2.18-debian-trixie-slim |
| Rocky Linux 10 | 2.21-rockylinux-10 |
2.20-rockylinux-10 |
2.19-rockylinux-10 |
2.18-rockylinux-10 |
| Ubuntu 24.04 | 2.21-ubuntu-24.04 |
2.20-ubuntu-24.04 |
2.19-ubuntu-24.04 |
2.18-ubuntu-24.04 |
| Ubuntu 26.04 | 2.21-ubuntu-26.04 |
2.20-ubuntu-26.04 |
— | — |
Pull examples¶
Fully pinned tags¶
Immutable tags are also published with full patch versions. They follow this pattern:
Use fully pinned tags when you need to reproduce an exact image. Browse Docker Hub tags for the specific patch-level tag you need.
Choosing between tags¶
| Requirement | Recommended tag style |
|---|---|
| Quick local test | latest, alpine, or ubuntu |
| CI pipeline with planned upgrades | Matrix tag such as 2.21-ubuntu-24.04 |
| Reproducible release build | Fully pinned patch-level tag |
| Small image footprint | Alpine tag |
| glibc compatibility | Debian, Ubuntu, or Rocky Linux tag |
Supported does not mean identical
Images in the same Ansible stream include the same Ansible core stream, but package availability, shell tools, and C library behavior come from the base operating system.