geerlingguy / docker-amazonlinux2023-ansible

Amazon Linux 2023 Docker container for Ansible playbook and role testing.

Amazon Linux 2023 Ansible Test Image

Amazon Linux 2023 Docker container for Ansible playbook and role testing.

Tags

• latest: Latest stable version of Ansible.

The latest tag is a lightweight image for basic validation of Ansible playbooks.

How to Build

This image is built on Docker Hub automatically any time the upstream OS container is rebuilt, and any time a commit is made or merged to the master branch. But if you need to build the image on your own locally, do the following:

1. Install Docker.
2. cd into this directory.
3. Run docker build -t amazonlinux2023-ansible .

How to Use

1. Install Docker.
2. Pull this image from Docker Hub: docker pull geerlingguy/docker-amazonlinux2023-ansible:latest (or use the image you built earlier, e.g. amazonlinux2023-ansible:latest).
3. Run a container from the image: docker run --detach --privileged --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw --cgroupns=host geerlingguy/docker-amazonlinux2023-ansible:latest (to test my Ansible roles, I add in a volume mounted from the current working directory with --volume=`pwd`:/etc/ansible/roles/role_under_test:ro).
4. Use Ansible inside the container: a. docker exec --tty [container_id] env TERM=xterm ansible --version b. docker exec --tty [container_id] env TERM=xterm ansible-playbook /path/to/ansible/playbook.yml --syntax-check

Notes

I use Docker to test my Ansible roles and playbooks on multiple OSes using CI tools like Jenkins and Travis. This container allows me to test roles and playbooks using Ansible running locally inside the container.

Important Note: I use this image for testing in an isolated environment—not for production—and the settings and configuration used may not be suitable for a secure and performant production environment. Use on production servers/in the wild at your own risk!

Author

Created in 2023 by Jeff Geerling, author of Ansible for DevOps.

docker-amazonlinux2023-ansible's Issues

Amazon Linux 2023

Now that Amazon Linux 2023 has been officially released, can we rename this repo to docker-amazonlinux2023-ansible and modify the Dockerfile to start from amazonlinux:2023?

Systemd errors

I receive consistent systemd issues running this container in my GHA environment that I cannot reproduce in a Codespace or locally - https://github.com/artis3n/ansible-role-tailscale/actions/runs/5015792772/jobs/8991827218#step:6:233

Looking at this image vs. one I was using before, the difference seems to be using yum here vs. def and I am installing systemd whereas I don't see it installed in this image. https://github.com/artis3n/docker-amazonlinux2023-ansible/blob/main/Dockerfile#L12

Would you be interested in accepting a PR bringing the changes in my image over to your Dockerfile? Alternatively, the errors can't be reliably reproduced outside of this single environment so you may not be interested in changing your image.