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.

Note: The container images are NOT intended for production use and should only be used for testing purposes. The security of the container images is not guaranteed and the images are not updated with the latest security patches.

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.

Currently, the following distributions are supported:

• - ghcr.io/hspaans/molecule-containers:amazonlinux-2023
• - ghcr.io/hspaans/molecule-containers:debian-11
• - ghcr.io/hspaans/molecule-containers:debian-12
• - ghcr.io/hspaans/molecule-containers:fedora-41
• - ghcr.io/hspaans/molecule-containers:oraclelinux-8
• - ghcr.io/hspaans/molecule-containers:oraclelinux-9
• - ghcr.io/hspaans/molecule-containers:rockylinux-8
• - ghcr.io/hspaans/molecule-containers:rockylinux-9
• - ghcr.io/hspaans/molecule-containers:ubuntu-22.04
• - ghcr.io/hspaans/molecule-containers:ubuntu-24.04

Unmaintained images:

• - ghcr.io/hspaans/molecule-containers:debian-10
• - ghcr.io/hspaans/molecule-containers:fedora-38
• - ghcr.io/hspaans/molecule-containers:fedora-39
• - ghcr.io/hspaans/molecule-containers:fedora-40
• - ghcr.io/hspaans/molecule-containers:ubuntu-20.04

Experimental images are available for the following distributions:

• - ghcr.io/hspaans/molecule-containers:alpine-3.18
• - ghcr.io/hspaans/molecule-containers:alpine-3.19
• - ghcr.io/hspaans/molecule-containers:alpine-3.20
• - ghcr.io/hspaans/molecule-containers:alpine-3.21
• - ghcr.io/hspaans/molecule-containers:debian-13
• - ghcr.io/hspaans/molecule-containers:opensuse-15

Note: Previous images were stored in the hspaans/molecule-container-<distribution>:<version> package repository on GitHube. These images are no longer maintained and will be removed in the future as they become end-of-life. It is recommended to use the new images from the ghcr.io/hspaans/molecule-containers:<distribution>-<version> package repository.

Example Molecule scenario

The example molecule.yml below is a scenario to run test on Debian 12 and Ubuntu 22.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-22.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