ansible/test/integration
Will Thames ab8490d003 Added warnings to command module
Generate warnings when users are shelling out to commands
rather than using modules

Can be turned off on a per-action line with the documented
warn=False flag. Can be turned off globally using
command_warnings = False in ansible config file.

Print out warnings using the standard playbook callbacks.

Created some additional tests in TestRunner.test_command
and also a demonstration playbook.
2014-08-22 15:37:07 -04:00
..
group_vars First pass at ec2 module tests 2014-02-26 16:43:30 -05:00
host_vars Adding an integration test for variable precedence 2014-05-09 11:42:57 -05:00
roles Added warnings to command module 2014-08-22 15:37:07 -04:00
vars Correct variable blending from vars_files with hostvars in them 2014-08-20 15:49:01 -05:00
all.yml Add a lot of tests to verify parsing routines for scenarios that should pass. Some changes TBD, like stripping command spaces off end of expressions. 2014-07-23 22:10:58 -04:00
amazon.yml Re-enable the ec2_eip test 2014-08-05 09:20:23 -05:00
bad_parsing.yml Add missing file. 2014-07-23 23:32:45 -04:00
check_mode.yml
cleanup_ec2.py Added an integration test for the ec2_asg module 2014-06-05 16:18:31 -05:00
cleanup_gce.py Changes cleanup_gce.py to use gce_credentials module. 2014-04-13 18:38:31 -07:00
credentials.template Adds integration tests for gce module. 2014-04-13 18:38:30 -07:00
destructive.yml Adding test Coverage for mysql_variable module 2014-08-01 12:15:05 -04:00
galaxy_playbook.yml Allow installation of roles from yaml roles file 2014-08-21 17:15:23 -04:00
galaxy_roles.yml Handle older git archive commands 2014-08-21 17:15:23 -04:00
galaxy_rolesfile Handle older git archive commands 2014-08-21 17:15:23 -04:00
gce.yml Adds integration tests for gce_pd module. 2014-04-13 18:38:31 -07:00
gce_credentials.py Adds support for creating GCE persistent disks from snapshots 2014-04-13 18:38:31 -07:00
good_parsing.yml Add a lot of tests to verify parsing routines for scenarios that should pass. Some changes TBD, like stripping command spaces off end of expressions. 2014-07-23 22:10:58 -04:00
integration_config.yml
inventory Adding an integration test for the ec2_elb module 2014-04-28 20:37:08 -05:00
inventory.group_by Add integration tests for group_by module. Fixed bug introduced by ansible/ansible#7273 while also fixing issue described in ansible/ansible#6953 2014-05-06 22:30:37 -04:00
inventory.handlers Ensure handlers run when meta tasks are defined and add handler integration tests 2014-03-25 13:33:52 -04:00
inventory.winrm.template Add winrm integration tests for raw, script and ping modules. 2014-06-19 14:24:13 -05:00
Makefile Remove galaxy CLI tests that hit bitbucket as bitbucket is hanging tests - maybe replace with nice github examples later :) 2014-08-22 14:06:08 -04:00
non_destructive.yml Fixing some parsing issues in authorized_key module 2014-04-02 15:02:54 -05:00
rackspace.yml
README.md Add winrm integration tests for raw, script and ping modules. 2014-06-19 14:24:13 -05:00
setup_gce.py Adds support for attaching persistent disks to GCE instances 2014-04-13 18:38:31 -07:00
test_group_by.yml Add integration tests for group_by module. Fixed bug introduced by ansible/ansible#7273 while also fixing issue described in ansible/ansible#6953 2014-05-06 22:30:37 -04:00
test_handlers.yml Correct issue of handlers running on all hosts incorrectly 2014-05-27 12:03:08 -05:00
test_hash.yml
test_includes.yml Verify playbook includes can take params. 2014-07-26 10:41:23 -04:00
test_includes2.yml Verify playbook includes can take params. 2014-07-26 10:41:23 -04:00
test_setup.yml
test_var_precedence.yml Correct variable blending from vars_files with hostvars in them 2014-08-20 15:49:01 -05:00
test_vault.yml Change name of vault integration test 2014-06-10 10:07:50 -05:00
test_winrm.yml Add integration tests for win_service module. 2014-07-02 08:12:40 -04:00
unicode.yml Remove unnecessary unicode conversions from parse_kv 2014-08-04 09:59:08 -05:00
vars_file.yml
vault-password Added integration tests for encrypted vars 2014-05-21 21:06:47 +02:00

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.

Windows Tests

These tests exercise the winrm connection plugin and Windows modules. You'll need to define an inventory with a remote Windows 2008 or 2012 Server to use for testing, and enable PowerShell Remoting to continue.

Running these tests may result in changes to your Windows host, so don't run them against a production/critical Windows environment.

Enable PowerShell Remoting (run on the Windows host via Remote Desktop): Enable-PSRemoting -Force

Define Windows inventory: cp inventory.winrm.template inventory.winrm ${EDITOR:-vi} inventory.winrm

Run the tests: make test_winrm