History

James Laska 750d9e2d59 Update credentials.yml documentation and handling Changes include: * Update Makefile to use credentials.yml when it exists * Add details on the use of the credentials.yml file to README.md. * Update credentials.template comments		2014-03-18 10:17:44 -04:00
..
group_vars	First pass at ec2 module tests	2014-02-26 16:43:30 -05:00
host_vars	Fix test_async by using env python	2014-03-06 13:32:05 -05:00
roles	Merge branch 'file_fixes_clean' of https://github.com/bcoca/ansible into bcoca-file_fixes_clean	2014-03-17 14:03:26 -05:00
vars	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00
all.yml	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00
amazon.yml	First pass at ec2 module tests	2014-02-26 16:43:30 -05:00
check_mode.yml	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00
cleanup_ec2.py	[test_ec2*] cloud integration test updates	2014-03-13 11:28:02 -04:00
credentials.template	Update credentials.yml documentation and handling	2014-03-18 10:17:44 -04:00
destructive.yml	Add integration test for apt_repository	2014-03-14 13:07:12 -04:00
integration_config.yml	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00
inventory	First pass at ec2 module tests	2014-02-26 16:43:30 -05:00
Makefile	Update credentials.yml documentation and handling	2014-03-18 10:17:44 -04:00
non_destructive.yml	Adding new tests for assemble role	2014-02-24 14:27:23 -06:00
rackspace.yml	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00
README.md	Update credentials.yml documentation and handling	2014-03-18 10:17:44 -04:00
test_hash.yml	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00
test_setup.yml	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00
vars_file.yml	Rename tests to test, use old directory name.	2014-02-20 19:11:15 -05:00

README.md

Integration tests

The ansible integration system.

Tests for playbooks, by playbooks.

Some tests may require credentials. Credentials may be specified with credentials.yml.

Tests should be run as root.

Configuration

Making your own version of integration_config.yml can allow for setting some tunable parameters to help run the tests better in your environment. Some tests (e.g. cloud) will only run when access credentials are provided. For more information about supported credentials, refer to credentials.template.

Prerequisites

The tests will assume things like hg, svn, and git are installed and in path.

(Complete list pending)

Non-destructive Tests

These tests will modify files in subdirectories, but will not do things that install or remove packages or things outside of those test subdirectories. They will also not reconfigure or bounce system services.

Run as follows:

make non_destructive

You can select specific tests with the --tags parameter.

TEST_FLAGS="--tags test_vars_blending" make

Destructive Tests

These tests are allowed to install and remove some trivial packages. You will likely want to devote these to a virtual environment. They won't reformat your filesystem, however :)

make destructive

Cloud Tests

Cloud tests exercise capabilities of cloud modules (e.g. ec2_key). These are not 'tests run in the cloud' so much as tests that leverage the cloud modules and are organized by cloud provider.

In order to run cloud tests, you must provide access credentials in a file named credentials.yml. A sample credentials file named credentials.template is available for syntax help.

Provide cloud credentials: cp credentials.template credentials.yml ${EDITOR:-vi} credentials.yml

Run the tests: make cloud

WARNING running cloud integration tests will create and destroy cloud resources. Running these tests may result in additional fees associated with your cloud account. Care is taken to ensure that created resources are removed. However, it is advisable to inspect your AWS console to ensure no unexpected resources are running.