gliech/docker-archlinux-ansible repository overview

⁠Archlinux Ansible Test Image

Archlinux Docker container for Ansible playbook and role testing. Adapted from Jeff Geerlings⁠ fabulous container images for ansible testing⁠.

⁠How to Build

The image is built once a week in this GitHub actions workflow⁠ to keep the repository on Docker Hub⁠ up to date with arch linux's rolling release. 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 archlinux-ansible .

⁠How to Use

1. Install Docker⁠.
2. Pull this image from Docker Hub: docker pull gliech/docker-archlinux-ansible:latest (or use the image you built earlier, e.g. archlinux-ansible:latest).
3. Run a container from the image: docker run --detach --privileged --volume=/sys/fs/cgroup:/sys/fs/cgroup:ro gliech/docker-archlinux-ansible:latest (to test Ansible roles, you can 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:
   1. docker exec --tty [container_id] env TERM=xterm ansible --version
   2. docker exec --tty [container_id] env TERM=xterm ansible-playbook /path/to/ansible/playbook.yml --syntax-check

⁠Authors

Original images⁠ and documentation by Jeff Geerling⁠, author of Ansible for DevOps⁠. Adapted for Archlinux by Gregor Bückendorf.