Skip to content

Projects

The willhallonline Docker Ansible ecosystem is a small set of repositories for running Ansible consistently from Docker containers and CI workflows.

At the centre is the willhallonline/ansible image family. The related projects provide a GitHub Action wrapper, test repositories, and reusable test utilities.

Repository ownership

The core images are maintained by Will Hall and published from the willhallonline/docker-ansible repository.

Current project tags

Project Current tag
Docker Ansible v6.4.9
Docker Ansible GitHub Action v1.1.0
Docker Ansible Test v2.7.4
Docker Ansible GitHub Action Test integration-test v1.1.0

Ecosystem map

Project Repository Purpose
Docker Ansible willhallonline/docker-ansible Builds Ansible Docker images for Alpine, Ubuntu, Rocky Linux, and Debian with multiple supported Ansible versions.
Docker Hub image willhallonline/ansible Published container images containing ansible-core, ansible, and ansible-lint.
Docker Ansible GitHub Action willhallonline/docker-ansible-github-action Docker-based GitHub Action for running Ansible from the image family.
Docker Ansible Test willhallonline/docker-ansible-test Test repository used to exercise the Docker Ansible images.
Docker Ansible GitHub Action Test willhallonline/docker-ansible-github-action-test Test repository used to exercise the Docker Ansible GitHub Action.
Test utilities testing-utils/ Helper files and scripts used by the core image test workflows.
Project website docker-ansible/docker-ansible.github.io MkDocs Material documentation site for the ecosystem.

How the repositories fit together

graph TD
  A[docker-ansible] --> B[willhallonline/ansible images]
  B --> C[docker-ansible-github-action]
  B --> D[docker-ansible-test]
  C --> E[docker-ansible-github-action-test]
  A --> F[testing-utils]
  A --> G[Documentation site]

The core repository builds the images. The GitHub Action consumes those images. The test repositories verify that common image and action workflows keep working. Current images run as the non-root ansible user by default.

Core image family

The Docker Hub image is published as:

willhallonline/ansible

Images are built across several base operating systems and Ansible versions. Current Ansible versions include:

  • 2.18.19
  • 2.19.13
  • 2.20.9
  • 2.21.4

Pin your runtime

Use an explicit Ansible-version and base-OS tag for repeatable automation. See the image tag reference when choosing production tags.

Common user journeys

If you want to... Start with...
Run Ansible locally without installing Python packages on your host docker-ansible.md
Run a playbook in GitHub Actions github-action.md
Check that an image works in your environment testing.md
Decide which image tag to use ../reference/faq.md
Diagnose Docker or Ansible runtime errors ../reference/troubleshooting.md
Harden CI and image usage ../reference/security.md

Maintainer

The ecosystem is maintained by Will Hall.

Project pages