Docker Molecule Images

Docker Molecule Images for Testing Ansible Roles - A comprehensive collection of containerized Linux distributions designed specifically for testing Ansible playbooks across multiple operating systems.

Overview

This project provides ready-to-use Docker images for numerous Linux distributions, enabling developers to test their Ansible roles in realistic environments without requiring full virtual machines. Each image is carefully configured with the appropriate init system (systemd, OpenRC, or upstart) to properly support service management during Ansible testing.

Available Distributions

Alpine Linux

• alpine-openrc - Alpine Linux with OpenRC init system

Amazon Linux

• amazonlinux2023 - Amazon Linux 2023 with systemd
• amazonlinux2 - Amazon Linux 2 with systemd
• amazonlinux1 - Amazon Linux 1 with upstart ⚠️ (Deprecated - EOL July 2023)

Arch Linux

• archlinux - Arch Linux with systemd

CentOS

• centos-stream9 - CentOS Stream 9 with systemd
• centos7 - CentOS 7 with systemd ⚠️ (Deprecated - EOL June 2024)

Debian

• debian13 - Debian 13 (Trixie) with systemd
• debian12 - Debian 12 (Bookworm) with systemd
• debian11 - Debian 11 (Bullseye) with systemd
• debian10 - Debian 10 (Buster) with systemd ⚠️ (Deprecated - EOL June 2024)
• debian9 - Debian 9 (Stretch) with systemd ⚠️ (Deprecated - EOL June 2022)

Fedora

• fedora43 - Fedora 43 with systemd
• fedora42 - Fedora 42 with systemd
• fedora41 - Fedora 41 with systemd
• fedora40 - Fedora 40 with systemd
• fedora39 - Fedora 39 with systemd ⚠️ (Deprecated - EOL November 2024)
• fedora38 - Fedora 38 with systemd ⚠️ (Deprecated - EOL May 2024)
• fedora37 - Fedora 37 with systemd ⚠️ (Deprecated - EOL November 2023)

Kali Linux

• kalilinux - Kali Linux rolling with systemd

OpenSUSE

• opensuse - OpenSUSE with systemd

Oracle Linux

• oraclelinux9 - Oracle Linux 9 with systemd
• oraclelinux8 - Oracle Linux 8 with systemd
• oraclelinux7 - Oracle Linux 7 with systemd ⚠️ (Deprecated - EOL June 2024)

Rocky Linux

• rockylinux10 - Rocky Linux 10 with systemd
• rockylinux9 - Rocky Linux 9 with systemd
• rockylinux8 - Rocky Linux 8 with systemd ⚠️ (Deprecated - EOL May 2025)

AlmaLinux

• almalinux10 - AlmaLinux 10 with systemd
• almalinux9 - AlmaLinux 9 with systemd

RHEL

• rhel9 - Red Hat Enterprise Linux 9 with systemd

SUSE

• sles15 - SUSE Linux Enterprise Server 15 with systemd
• opensuse-tumbleweed - openSUSE Tumbleweed with systemd

Ubuntu

• ubuntu2510 - Ubuntu 25.10 with systemd
• ubuntu2504 - Ubuntu 25.04 (Plucky) with systemd
• ubuntu2410 - Ubuntu 24.10 (Oracular) with systemd
• ubuntu2404 - Ubuntu 24.04 (Noble) with systemd
• ubuntu2304 - Ubuntu 23.04 (Lunar) with systemd
• ubuntu2204 - Ubuntu 22.04 (Jammy) with systemd
• ubuntu2004 - Ubuntu 20.04 (Focal) with systemd ⚠️ (Deprecated - EOL April 2025)
• ubuntu1804 - Ubuntu 18.04 (Bionic) with systemd ⚠️ (Deprecated - EOL April 2023)

Usage

With Ansible Molecule

Add to your molecule.yml configuration:

driver:
  name: docker

platforms:
  - name: instance
    image: ghcr.io/buluma/<distribution>:latest
    # Or use Docker Hub: docker.io/buluma/<distribution>:latest
    privileged: true
    volumes:
      - /sys/fs/cgroup:/sys/fs/cgroup:rw
    cgroupns_mode: host
    command: ""
    tty: true

Standalone Usage

Pull and run any image directly:

# Pull the image
docker pull ghcr.io/buluma/ubuntu2204:latest

# Run interactively
docker run -it --rm --privileged -v /sys/fs/cgroup:/sys/fs/cgroup:rw ghcr.io/buluma/ubuntu2204:latest

Build Status

Alpine

Archlinux

Amazonlinux

Centos

Debian

Fedora

Kalilinux

Opensuse

Oraclelinux

Rockylinux

AlmaLinux

RHEL

SUSE

Ubuntu

Features

• ✅ Multi-Architecture Support: Images built for multiple architectures (amd64, arm64, arm/v6, arm/v7, ppc64le, s390x, 386)
• ✅ Proper Init Systems: Each distribution configured with appropriate init system for service testing
• ✅ Security Scanning: Integrated with Docker Scout for automated vulnerability assessments
• ✅ Mandatory Verification: All releases are verified via CI tests before deployment
• ✅ Consistent Interface: Uniform configuration approach across all distributions
• ✅ Regular Updates: Automated builds with Renovate bot for keeping base images current
• ✅ CI/CD Ready: Optimized for use in continuous integration pipelines

Contributing

1. Fork the repository
2. Create a new branch for your distribution
3. Add a new directory with your Dockerfile
4. Create a corresponding workflow in .github/workflows/
5. Submit a pull request

License

Licensed under the Apache License, Version 2.0. See LICENSE for more information.

Author Information

Created and maintained by Michael Buluma (@buluma)