ansible/test/integration
Robin Roth 2b28beb1d7 add check_mode option for tasks (#16056)
* add check_mode option for tasks

includes example testcases for the template module

* extend check_mode option

* replace always_run, see also proposal rename_always_run
* rename always_run where used and add deprecation warning
* add some documentation

* have check_mode overwrite always_run

* use unique template name to prevent conflicts

test_check_mode was right before, but failed due to using the same filename as other roles

* still mention always_run in the docs

* set deprecation of always_run to version 2.4

* fix rst style

* expand documentation on per-task check mode
2016-07-22 20:40:14 -04:00
..
group_vars
host_vars breaks testing in non virtual envs, since env var can be used in those 2015-11-12 09:40:43 -08:00
library Add GPL3 header to helloworld.go 2016-05-12 12:25:09 -05:00
lookup_paths
roles add check_mode option for tasks (#16056) 2016-07-22 20:40:14 -04:00
test_blocks Mark tasks expected to fail with EXPECTED FAILURE. 2016-05-31 11:29:04 -07:00
vars
all.yml
amazon.yml
azure.yml
bad_parsing.yml
check_mode.yml
cleanup_azure.py
cleanup_ec2.py
cleanup_gce.py
cleanup_rax.py
cloudflare.yml Add integration tests for the cloudflare_dns module 2016-03-25 21:22:29 +01:00
cloudstack.yml cloudstack: new integration tests test_cs_resourcelimit 2016-03-15 21:41:08 +01:00
consul.yml
consul_inventory.yml
consul_running.py
credentials.template Add integration tests for the cloudflare_dns module 2016-03-25 21:22:29 +01:00
destructive.yml Add tags for modules without dedicated test roles. 2016-07-07 12:42:07 -07:00
galaxy_playbook.yml
galaxy_playbook_git.yml [hotfix] add missed playbook file 2016-01-21 14:08:26 +02:00
galaxy_roles.yml Add tests for #10620 2015-11-18 20:47:54 +10:00
galaxy_rolesfile Add tests for #10620 2015-11-18 20:47:54 +10:00
gce.yml
gce_credentials.py
good_parsing.yml
integration_config.yml
inventory add a fact gathering check for the default of all 2016-03-15 11:58:23 -07:00
inventory.group_by
inventory.handlers
inventory.local re-integrate test_test_infra output checking 2016-03-18 10:14:22 -07:00
inventory.winrm.template Add connection tests for winrm connection plugin. 2016-03-31 08:32:41 -07:00
lookup.ini
lookup.properties
Makefile Fix test_async. (#16552) 2016-07-01 17:59:06 -07:00
no_log_local.yml
non_destructive.yml Add test tags for shell and command modules. 2016-07-08 17:41:58 -07:00
rackspace.yml
README.md
setup_gce.py
test_async.yml Fix test_async. (#16552) 2016-07-01 17:59:06 -07:00
test_binary_modules.yml Add integration tests for binary modules 2016-05-12 12:25:09 -05:00
test_connection.inventory lxc connection plugin 2016-05-28 00:15:09 +02:00
test_connection.yml Add unicode dir to connection tests. 2016-03-11 16:55:14 -08:00
test_connection_winrm.yml Add connection tests for winrm connection plugin. 2016-03-31 08:32:41 -07:00
test_delegate_to.yml
test_environment.yml Fix YAML source and check it on Shippable (#15678) 2016-06-04 10:58:17 -07:00
test_filters.yml
test_force_handlers.yml
test_gathering_facts.yml Make the fact gathering give a little more information on failure 2016-03-15 12:32:27 -07:00
test_group_by.yml
test_handlers.yml
test_hash.yml fix default/main.yml to defaults/main.yml 2016-07-02 21:16:33 +09:00
test_includes.yml Use loop_control.loop_var directly 2016-07-01 07:03:42 +05:30
test_includes2.yml
test_includes3.yml Use loop_control.loop_var directly 2016-07-01 07:03:42 +05:30
test_includes4.yml Use loop_control.loop_var directly 2016-07-01 07:03:42 +05:30
test_lookup_properties.yml
test_setup.yml
test_tags.yml
test_templating_settings.yml
test_test_infra.yml Mark tasks expected to fail with EXPECTED FAILURE. 2016-05-31 11:29:04 -07:00
test_var_precedence.yml reformated test, changed big assert to with_items 2015-12-01 21:11:12 -08:00
test_vault.yml feature/copy-vault-dataloader: Add method get_real_file(file_path) to dataloader 2016-04-14 14:12:48 -04:00
test_winrm.yml Windows: win_regedit integration tests (following https://github.com/ansible/ansible-modules-extras/pull/2034 ) 2016-04-14 21:47:17 +01:00
unicode-test-script Fix problems with non-ascii values passed as part of the command to connection plugins 2016-01-04 20:35:25 -08:00
unicode.yml More fixes for unicode handling in the connection plugins. 2016-01-06 15:19:40 -08:00
vars_file.yml
vault-password
vault-secret.txt feature/copy-vault-dataloader: Add method get_real_file(file_path) to dataloader 2016-04-14 14:12:48 -04: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