Containers for Molecule

For testing Ansible roles with Molecule, it is useful to have a container image with Ansible installed. This repository contains a collection of container images for testing Ansible roles with Molecule. The container images are available on GitHub Container Registry and a current list of available images can be found on the container overview page.

Warning

The container images are NOT intended for production use and should only be used for testing purposes without the latest patches applied.

Container images and versions

Distributions are based on LTS versions with official support and fall within N and N-1. Older images are removed from the registry when they reach end-of-life when public security support ends.

The following table lists the available container images, their distribution, and the state of the image. The state is indicated by a badge that shows the status of the latest build for that image.

Image Tag	Distribution	State
almalinux-10	AlmaLinux 10
alpine-3.19	Alpine 3.19
alpine-3.20	Alpine 3.20
alpine-3.21	Alpine 3.21
alpine-3.22	Alpine 3.22
amazonlinux-2023	Amazon Linux 2023
debian-12	Debian 12 (Bookworm)
debian-13	Debian 13 (Trixie)
fedora-41	Fedora 41
fedora-42	Fedora 42
oraclelinux-8	Oracle Linux 8
oraclelinux-9	Oracle Linux 9
oraclelinux-10	Oracle Linux 10
rockylinux-8	Rocky Linux 8
rockylinux-9	Rocky Linux 9
rockylinux-10	Rocky Linux 10
ubuntu-22.04	Ubuntu 22.04 (Jammy Jellyfish)
ubuntu-24.04	Ubuntu 24.04 (Noble Numbat)

Example Molecule scenario

The example molecule.yml below is a scenario to run test on Debian 12 and Ubuntu 24.04.

---
dependency:
  name: galaxy
driver:
  name: docker
lint: |
  set -e
  yamllint `git ls-files '*.yaml' '*.yml'`
  ansible-lint
  flake8

platforms:
  - name: debian-12
    image: "ghcr.io/hspaans/molecule-containers:debian-12"
    command: ""
    cgroupns_mode: host
    volumes:
      - /sys/fs/cgroup:/sys/fs/cgroup:rw
    privileged: true
    pre_build_image: true

  - name: ubuntu-22.04
    image: "ghcr.io/hspaans/molecule-containers:ubuntu-24.04"
    command: ""
    cgroupns_mode: host
    volumes:
      - /sys/fs/cgroup:/sys/fs/cgroup:rw
    privileged: true
    pre_build_image: true

provisioner:
  name: ansible
verifier:
  name: testinfra