-
-
Save geerlingguy/73ef1e5ee45d8694570f334be385e181 to your computer and use it in GitHub Desktop.
#!/bin/bash | |
# | |
# Ansible role test shim. | |
# | |
# Usage: [OPTIONS] ./tests/test.sh | |
# - distro: a supported Docker distro version (default = "centos7") | |
# - playbook: a playbook in the tests directory (default = "test.yml") | |
# - role_dir: the directory where the role exists (default = $PWD) | |
# - cleanup: whether to remove the Docker container (default = true) | |
# - container_id: the --name to set for the container (default = timestamp) | |
# - test_idempotence: whether to test playbook's idempotence (default = true) | |
# | |
# If you place a requirements.yml file in tests/requirements.yml, the | |
# requirements listed inside that file will be installed via Ansible Galaxy | |
# prior to running tests. | |
# | |
# License: MIT | |
# Exit on any individual command failure. | |
set -e | |
# Pretty colors. | |
red='\033[0;31m' | |
green='\033[0;32m' | |
neutral='\033[0m' | |
timestamp=$(date +%s) | |
# Allow environment variables to override defaults. | |
distro=${distro:-"rockylinux8"} | |
playbook=${playbook:-"test.yml"} | |
role_dir=${role_dir:-"$PWD"} | |
cleanup=${cleanup:-"true"} | |
container_id=${container_id:-$timestamp} | |
test_idempotence=${test_idempotence:-"true"} | |
## Set up vars for Docker setup. | |
# Rocky Linux 9 | |
if [ $distro = 'rockylinux9' ]; then | |
init="/usr/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Rocky Linux 8 | |
elif [ $distro = 'rockylinux8' ]; then | |
init="/usr/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# CentOS 7 | |
elif [ $distro = 'centos7' ]; then | |
init="/usr/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Ubuntu 22.04 | |
elif [ $distro = 'ubuntu2204' ]; then | |
init="/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Ubuntu 20.04 | |
elif [ $distro = 'ubuntu2004' ]; then | |
init="/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Ubuntu 18.04 | |
elif [ $distro = 'ubuntu1804' ]; then | |
init="/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Debian 12 | |
elif [ $distro = 'debian12' ]; then | |
init="/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Debian 11 | |
elif [ $distro = 'debian11' ]; then | |
init="/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Debian 10 | |
elif [ $distro = 'debian10' ]; then | |
init="/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Fedora 38 | |
elif [ $distro = 'fedora38' ]; then | |
init="/usr/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Fedora 37 | |
elif [ $distro = 'fedora37' ]; then | |
init="/usr/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
# Fedora 36 | |
elif [ $distro = 'fedora36' ]; then | |
init="/usr/lib/systemd/systemd" | |
opts="--privileged --cgroupns=host --volume=/var/lib/docker --volume=/sys/fs/cgroup:/sys/fs/cgroup:rw" | |
fi | |
# Run the container using the supplied OS. | |
printf ${green}"Starting Docker container: geerlingguy/docker-$distro-ansible."${neutral}"\n" | |
docker pull geerlingguy/docker-$distro-ansible:latest | |
docker run --detach --volume="$role_dir":/etc/ansible/roles/role_under_test:rw --name $container_id $opts geerlingguy/docker-$distro-ansible:latest $init | |
printf "\n" | |
# Install requirements if `requirements.yml` is present. | |
if [ -f "$role_dir/tests/requirements.yml" ]; then | |
printf ${green}"Requirements file detected; installing dependencies."${neutral}"\n" | |
docker exec --tty $container_id env TERM=xterm ansible-galaxy install -r /etc/ansible/roles/role_under_test/tests/requirements.yml | |
fi | |
printf "\n" | |
# Test Ansible syntax. | |
printf ${green}"Checking Ansible playbook syntax."${neutral} | |
docker exec --tty $container_id env TERM=xterm ansible-playbook /etc/ansible/roles/role_under_test/tests/$playbook --syntax-check | |
printf "\n" | |
# Run Ansible playbook. | |
printf ${green}"Running command: docker exec $container_id env TERM=xterm ansible-playbook /etc/ansible/roles/role_under_test/tests/$playbook"${neutral} | |
docker exec $container_id env TERM=xterm env ANSIBLE_FORCE_COLOR=1 ansible-playbook /etc/ansible/roles/role_under_test/tests/$playbook | |
if [ "$test_idempotence" = true ]; then | |
# Run Ansible playbook again (idempotence test). | |
printf ${green}"Running playbook again: idempotence test"${neutral} | |
idempotence=$(mktemp) | |
docker exec $container_id ansible-playbook /etc/ansible/roles/role_under_test/tests/$playbook | tee -a $idempotence | |
tail $idempotence \ | |
| grep -q 'changed=0.*failed=0' \ | |
&& (printf ${green}'Idempotence test: pass'${neutral}"\n") \ | |
|| (printf ${red}'Idempotence test: fail'${neutral}"\n" && exit 1) | |
fi | |
# Remove the Docker container (if configured). | |
if [ "$cleanup" = true ]; then | |
printf "Removing Docker container...\n" | |
docker rm -f $container_id | |
fi |
Just noting here that I've removed support for fedora24
(and added fedora29
), as well as ubuntu1204
, since those images are now marked as deprecated (since the upstream OSes are no longer maintained).
This gist should probably be changed to use suggestions from https://www.jeffgeerling.com/blog/2018/testing-your-ansible-roles-molecule :)
I've just added fedora30
and debian10
to the script. Note that I still use this script in some places where molecule
adds more overhead than I need.
Also added centos8
today.
Note that I still use this script in some places where molecule adds more overhead than I need.
@geerlingguy, could you expand that note? When is Molecule's overhead noticeable?
@sio - Sure! The overhead is less on the performance side (things run just as fast with molecule, in general), but more on the side of some projects not needing any of the extra features molecule provides. For example, sometimes I just want to start a container, run a playbook on it, and kill the container. I don't want the extra weight of having to install molecule (and its dependencies), and also manage a molecule.yml
file and extra molecule converge playbook just to test another playbook.
Today I dropped Ubuntu 14.04 and Fedora <30, and added Ubuntu 20.04.
I just dropped Fedora < 35, Ubuntu 16.04, and Debian < 10, also dropped CentOS 8 and 6, and added Rocky Linux 9, Debian 12, and all newer versions of Fedora up to 38.
@nickjj - The context for this script is a frequently-wiped CI environment, so I tend to not worry about the longevity of failed containers. For local environments it can be a little annoying... however long term I will be switching my roles over to use Molecule, so I don't know if I'm planning on updating this gist or not besides to fix breaking bugs.