History

Zuul 03fc4da48b Merge "Restore IP addresses configuration after spoofing MAC address"		2023-01-25 18:03:47 +00:00
..
README.rst	Fix docs markup consistency	2017-11-21 19:02:54 +09:00
__init__.py	add scenario directory	2013-05-17 08:52:22 -04:00
manager.py	Added functionality to wait for port creation	2022-11-28 17:04:29 +00:00
test_compute_unified_limits.py	Fix compute_unified decoration	2022-03-17 11:59:16 +02:00
test_dashboard_basic_ops.py	Move horizon test from tempest-horizon to tempest	2021-01-22 00:11:44 +00:00
test_encrypted_cinder_volumes.py	Add LUKS v2 tests	2022-06-29 22:42:22 +00:00
test_minimum_basic.py	Clean up scenario floating IP waiting	2022-07-27 18:52:32 +00:00
test_network_advanced_server_ops.py	Remove unstable_test decorator	2022-07-13 15:41:09 +02:00
test_network_basic_ops.py	Restore IP addresses configuration after spoofing MAC address	2023-01-23 11:39:56 +00:00
test_network_qos_placement.py	Fix TypeError in QoSBandwidthAndPacketRateTests	2022-02-02 10:36:55 +05:30
test_network_v6.py	Merge "Make _get_router() non-private"	2021-03-09 00:46:29 +00:00
test_object_storage_basic_ops.py	docs: Fix incorrect docstrings in reStructuredText format	2018-11-21 19:06:43 -06:00
test_security_groups_basic_ops.py	Rename create_networks to correct name as per its functionality	2021-03-25 18:21:28 +00:00
test_server_advanced_ops.py	Create default network for server advance scenario tests	2021-02-08 16:58:07 -06:00
test_server_basic_ops.py	Move floating IP operation from nova-network to neutron	2021-03-25 18:21:12 +00:00
test_server_multinode.py	Move test decorators to common	2017-08-23 17:09:33 +00:00
test_shelve_instance.py	Make _create_security_group() non-private	2021-03-01 18:47:09 +05:30
test_snapshot_pattern.py	Make _create_security_group() non-private	2021-03-01 18:47:09 +05:30
test_stamp_pattern.py	Make _create_security_group() non-private	2021-03-01 18:47:09 +05:30
test_unified_limits.py	Add tests for glance unified quotas	2021-07-16 08:11:08 -07:00
test_volume_backup_restore.py	Move floating IP operation from nova-network to neutron	2021-03-25 18:21:12 +00:00
test_volume_boot_pattern.py	Add LUKS v2 tests	2022-06-29 22:42:22 +00:00
test_volume_migrate_attached.py	Make _create_security_group() non-private	2021-03-01 18:47:09 +05:30

README.rst

Tempest Field Guide to Scenario tests

What are these tests?

Scenario tests are "through path" tests of OpenStack function. Complicated setups where one part might depend on completion of a previous part. They ideally involve the integration between multiple OpenStack services to exercise the touch points between them.

Any scenario test should have a real-life use case. An example would be:

"As operator I want to start with a blank environment":
1. upload a glance image
2. deploy a vm from it
3. ssh to the guest
4. create a snapshot of the vm

Why are these tests in Tempest?

This is one of Tempest's core purposes, testing the integration between projects.

Scope of these tests

Scenario tests should always use the Tempest implementation of the OpenStack API, as we want to ensure that bugs aren't hidden by the official clients.

Tests should be tagged with which services they exercise, as determined by which client libraries are used directly by the test.

Example of a good test

While we are looking for interaction of 2 or more services, be specific in your interactions. A giant "this is my data center" smoke test is hard to debug when it goes wrong.

A flow of interactions between Glance and Nova, like in the introduction, is a good example. Especially if it involves a repeated interaction when a resource is setup, modified, detached, and then reused later again.