litmusimage

This repository creates docker image files for testing puppet modules with Puppet Litmus.

The images have initd, systemd or upstart, along with SSH.

Images get uploaded automatically and are rebuilt nightly if necessary.

Buildable images

image	tag	dockerfile	base_image	base_tag
ubuntu	18.04	apt_sysvinit-utils	ubuntu	18.04
ubuntu	20.04	apt_sysvinit-utils	ubuntu	20.04
ubuntu	22.04	apt_sysvinit-utils	ubuntu	22.04
ubuntu	24.04	apt_sysvinit-utils	ubuntu	24.04
centos	6	yum_initd	centos	6
centos	7	yum_systemd	centos	7
centos	stream8	yum_systemd	quay.io/centos/centos	stream8
centos	stream9	yum_systemd	quay.io/centos/centos	stream9
scientificlinux	6	yum_initd	scientificlinux/sl	6
scientificlinux	7	yum_systemd	scientificlinux/sl	7
sles	15	zypper_systemd	registry.suse.com/suse/sle15	15.5
oraclelinux	6	yum_initd	oraclelinux	6
oraclelinux	7	yum_systemd	oraclelinux	7
oraclelinux	8	yum_systemd	oraclelinux	8
oraclelinux	9	yum_systemd	oraclelinux	9
rockylinux	8	yum_systemd	rockylinux/rockylinux	8
rockylinux	9	yum_systemd	rockylinux/rockylinux	9
almalinux	8	yum_systemd	almalinux	8
almalinux	9	yum_systemd	almalinux	9
redhat	7	yum_systemd	registry.access.redhat.com/ubi7/ubi-init	latest
redhat	8	yum_systemd	redhat/ubi8-init	latest
redhat	9	yum_systemd	redhat/ubi9-init	latest
debian	10	apt_sysvinit-utils	debian	10
debian	11	apt_sysvinit-utils	debian	bullseye
debian	12	apt_sysvinit-utils	debian	12
amazonlinux	2	yum_systemd	amazonlinux	2
amazonlinux	2023	yum_systemd	amazonlinux	2023
fedora	36	yum_systemd	fedora	36

Manual Building

docker build --rm --no-cache -t litmusimage/${IMAGE}:${TAG} . \
  -f ${DOCKERFILE}.dockerfile \
  --build-arg BASE_TAG=${BASE_TAG} \
  --build-arg OS_TYPE=${BASE_IMAGE}

For example with:

BASE_IMAGE=ubuntu
DOCKERFILE=apt_sysvinit-utils
IMAGE=ubuntu
TAG=22.04
BASE_TAG=${TAG}

The build command would be:

docker build --rm --no-cache -t litmusimage/ubuntu:22.04 . \
  -f apt_sysvinit-utils.dockerfile \
  --build-arg BASE_TAG=22.04 \
  --build-arg OS_TYPE=ubuntu

Push said image

# docker login
docker image push litmusimage/centos:stream9

Tips and tricks for docker wrangling

# List running and stopped containers
docker container ls -a

# remove a container
docker rm -f ubuntu_20.04-2224

# remove all containers
docker rm -f $(docker ps -a -q)

# jump into a container, force a shell
docker exec -it litmusimage_debian11_-2223 /bin/bash

# attach to a container ( limited by what pid 0 is)
docker attach litmusimage_ubuntu22.04_-2222

# safely exit a container, leaving it running
<ctrl> + p then <ctrl> + q

# get the latest version of the image
docker pull debian:10

# show the history of the image
docker image history litmusimage/ubuntu22.04

# remove all docker images that are on your local machine
docker rmi $(docker images -q)

Add new images

• Add/change dockerfile for the new image
• Every dockerfile needs a base_image label where the base image id will be stored. This will be used in the nightly build to identify if the base image has been updated.
• Change images.json to build the new images with CI
• New images will be pushed to Docker Hub only on pushes to the main branch, and will be updated nightly in case the base image has changed.

Future improvements

• Introduce variants with puppet agent pre-installed for litmus:install_agent

Custom images

Building and deploying custom images can be done by forking this repository and enabling Actions. Once enabled images will be pushed to your public ghcr.io registry by default. To push images to another package registry, set following Action secrets and variables:

name	type
DOCKER_USERNAME
DOCKER_PASSWORD	secret
DOCKER_REGISTRY
DOCKER_REPOSITORY