Ubuntu 20.04 Ansible Test Image

Ubuntu 20.04 container for Ansible playbook and role testing.

Image Tags

• latest: Latest stable version of Ansible (lightweight image for basic validation of Ansible playbooks).

How to Build

This image is built on GitHub automatically any time a commit is made or merged to the main branch and tagged. But if you need to build the image on your own locally, do the following:

1. Install Podman or Docker.

   • In the commands below, podman may be interchanged with docker depending on your choice.

2. cd into the directory containing this repository.

3. Build the image:

   podman build --file Containerfile --tag ubuntu2004-ansible .   

How to Use

1. Install Podman or Docker.

   • In the commands below, podman may be interchanged with docker depending on your choice.

2. Pull this image from GitHub (or use the image you built above ubuntu2004-ansible:latest):

   podman pull ghcr.io/chpc-uofu/container-ubuntu2004-ansible:latest

3. Run a container from the image:

   podman run --detach --privileged --volume=/sys/fs/cgroup:/sys/fs/cgroup:ro ghcr.io/chpc-uofu/container-ubuntu2004-ansible:latest

   To test Ansible roles it is helpful to add in a volume from the current working directory with the following option:

   --volume=${PWD}:/etc/ansible/roles/role_under_test:ro

4. Use Ansible inside the container. Here are a few examples.

   Check Ansible's version:

   podman exec --tty [container_id] env TERM=xterm ansible --version

   Check the syntax of an Ansible playbook:

   podman exec --tty [container_id] env TERM=xterm ansible-playbook /path/to/ansible/playbook.yml --syntax-check

How to Contribute

1. Submit a pull request against main.
2. Once the automated status checks pass, complete the pull request by squash-merging with main.
3. Apply a semantic version tag to the resulting commit (e.g. v1.0.1).
4. At this point the automatic image build on GitHub will trigger, tagging the new image with the semantic version and latest.

Author

Derived from geerlingguy/docker-ubuntu2004-ansible.