kblr/debian9-ansible repository overview

⁠Debian 9 (Stretch) Ansible test image

Debian 9 (Stretch) Docker image for Ansible role testing in Travis-CI.

⁠Overview

I use Docker in Travis-CI to test my Ansible roles on multiple OS.

This repo allows me to (automatically) build a Debian 9 image from the provided Dockerfile. This image contains the needed tools to run Ansible and the tests.

The image is built by Docker Hub automatically each time one of the following happens:

• the upstream OS container is updated;
• a commit is made on the master branch of this repo.

⁠How-to use with Travis-CI

Simply tell Travis to pull the image from Docker Hub and run a container based on it.

Your .travis.yml file should look like this:

sudo: required
language: bash
services:
  - docker

before_install:
  # Pull the image from Docker Hub:
  - docker pull kblr/debian9-ansible:latest

script:
  # Run a container based on the previously pulled image:
  - >
    docker run
    --name "${TRAVIS_COMMIT}.debian9"
    --detach
    --privileged
    --mount type=bind,source=/sys/fs/cgroup,target=/sys/fs/cgroup,readonly
    --mount type=bind,source="$(pwd)",target=/etc/ansible/roles/under_test,readonly
    kblr/debian9-ansible:latest

  # Execute tests:
  - >
    docker exec "${TRAVIS_COMMIT}.debian9"
    ansible-playbook -v /etc/ansible/roles/under_test/tests/test/yml --syntax-check

  - >
    docker exec ...

after_script:
  - docker rm -f "${TRAVIS_COMMIT}.debian9"

notifications:
  webhooks: https://galaxy.ansible.com/api/v1/notifications/

⁠How-to use locally

If you ever need to build the image manually:

1. Install Docker⁠
2. git clone this repo
3. cd in the freshly cloned repo
4. Build the image using docker build --no-cache --rm --tag="debian9:ansible" .
5. cd in your Ansible role directory
6. From there, run a container using docker run --name [whatever] --detach --privileged --mount type=bind,source=/sys/fs/cgroup,target=/sys/fs/cgroup,readonly --mount type=bind,source="$(pwd)",target=/etc/ansible/roles/under_test,readonly debian9:ansible

⁠Contributing

Code reviews, patches, comments, bug reports and feature requests are welcome. Please read the Contributing Guide⁠ for further details.