kblr/archlinux-ansible repository overview

⁠Archlinux Ansible test image

Archlinux 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 an Archlinux 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...

⁠...And Molecule (recommended)

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

To do so, edit your molecule.yml file like this (just an example, the most important part is in the platforms section):

---
dependency:
  name: galaxy
driver:
  name: docker
lint:
  name: yamllint
platforms:
  - name: instance
    image: "kblr/archlinux-ansible:latest"
    volumes:
      - /sys/fs/cgroup:/sys/fs/cgroup:ro
    privileged: true
    pre_build_image: true
provisioner:
  name: ansible
  lint:
    name: ansible-lint
  playbooks:
    converge: "playbook.yml"
scenario:
  name: default
verifier:
  name: testinfra
  lint:
    flake8
...

⁠...And bash (not advised)

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/archlinux-ansible:latest

script:
  # Run a container based on the previously pulled image:
  - >
    docker run
    --name "${TRAVIS_COMMIT}.archlinux"
    --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/archlinux-ansible:latest

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

  - >
    docker exec ...

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

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="archlinux: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 archlinux:ansible

⁠Contributing

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