# ansible-test

**Repository Path**: mirrors_andyglick/ansible-test

## Basic Information

- **Project Name**: ansible-test
- **Description**: An Ansible Testing Framework for Humans
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

ansible-test: Ansible Local Testing Framework
=============================================

Ansible-test is a tool for testing your automation on local docker images. You can think of this as a slim version of Chef's test-kitchen.

.. code-block:: bash

   $ cd /my/ansible/repository
   $ ansible-test my_ansible_role

The above command will drop a Dockerfile at the root of your ansible repo and initialize a docker image with ansible installed. It will then run the ansible role "my_ansible_role".

Note that ansible-test also accepts arbitrary arguments. These arguments will be passed on to the ansible-playbook command while running tests:

.. code-block:: bash

   ansible-test my_ansible_role --ask-vault-pass


Ansible test also accepts an image argument to specify the base docker image:

.. code-block:: bash

   ansible-test my_ansible_role --image ubuntu:latest

See the `example ansible flask project <https://github.com/nylas/ansible-flask-example>`_, which tests with ansible-test out-of-the-box

Installation
------------

To install ansible-test:

.. code-block:: bash

   $ pip install ansible-test

Documentation
-------------

ansible-test requires that you have docker installed locally. If you are using Mac OSX, I recommend you use boot2docker.

NOTE: Given docker's inflexibility with Dockerfiles, ansible-test will overwrite the Dockerfile in the current working directory from which you run ansible-test. This is currently the simplest way to integrate docker as a testing tool.