nylas/ansible-test

.. code-block:: bash

   usage: ansible-test [-h] [--image IMAGE] [--family {Debian,RedHat,Gentoo}]
                       role

   positional arguments:
     role                  Role to test

   optional arguments:
     -h, --help            show this help message and exit
     --image IMAGE, -i IMAGE
                           Docker Base Image
     --family {Debian,RedHat,Gentoo}, -f {Debian,RedHat,Gentoo}
                           ansible_os_family value for Base Image
   
Tested image/family combinations:

| image *debian:7.7* / family *Debian*  <-- default values if not specified
| image *centos:centos7.2.1511* / family *RedHat*
| image *gentoo-amd64-plus-portage* / family *Gentoo*

Gentoo notes
------------

Rather than being able to simply pull official gentoo docker images, it was necessary to merge the stage3 and portage images to work around a docker limitation: docker currently has no way to mount volumes while building an image, only when starting up a container from an already-built image (see https://github.com/docker/docker/issues/3949 for further discussion of this limitation).

See `base-images/Dockerfile.gentoo-amd64-portage <base-images/Dockerfile.gentoo-amd64-portage>`_ as example for creating base image for testing on Gentoo. This Dockerfile inherits from `gentoo/stage3-amd64 Dockerfile <https://github.com/gentoo/gentoo-docker-images/blob/master/amd64/Dockerfile>`_ and adds the commands from `gentoo/portage Dockerfile <https://github.com/gentoo/gentoo-docker-images/blob/master/portage/Dockerfile>`_ in order to create a full stage3 image with /usr/portage included rather than relying on a separage image containing a portage volume.