Debian 10 Ansible Test Image

Debian 10 (Buster) Docker container for Ansible playbook and role testing.
This container is used to test Ansible roles and playbooks (e.g. with molecule) running locally inside the container.
A non-priviledged user ansible is created with password-less sudo configured.

Tags

The following tags are available:

• latest: Latest stable version of Ansible

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. Clone the repository and cd into this directory.
3. Run docker build -t debian10-ansible .

How to Use Standalone

1. Install Docker.
2. Pull this image from Docker Hub or use the image you built earlier, e.g. called debian10-ansible:latest for the next step.

docker pull timgrt/debian10-ansible:latest

3. Run a container from the image. 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.

docker run --detach --privileged --volume=/sys/fs/cgroup:/sys/fs/cgroup:ro timgrt/debian10-ansible:latest

4. Use Ansible inside the container:

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

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

How to Use with Molecule

1. Install Docker.
2. Install Molecule.
3. Add Image in molecule.yml.

For example:

---
driver:
  name: docker
platforms:
  - name: debian10
    image: timgrt/debian10-ansible:latest
    tmpfs:
      - /run
      - /tmp
    volumes:
      - /sys/fs/cgroup:/sys/fs/cgroup:ro
    privileged: true
    command: "/lib/systemd/systemd"
    pre_build_image: true
provisioner:
  name: ansible
  config_options:
    defaults:
      interpreter_python: auto_silent
      callback_whitelist: profile_tasks, timer, yaml
      stdout_callback: yaml
    ssh_connection:
      pipelining: false
  inventory:
    host_vars:
      debian10:
        ansible_user: ansible

Author

Created 2021 by Tim Grützmacher, inspired by Jeff Geerling