From 9ea916368972a5af7dc339cd9a54a8f972c38c57 Mon Sep 17 00:00:00 2001 From: Dongcan Ye Date: Tue, 17 Jul 2018 10:24:08 +0000 Subject: [PATCH] Docs: Update API & Scenario Tests Add neutron-tempest-plugin project requirement, and add examples for running individual test modules or tests. TrivialFix Change-Id: I9f2ad39d17646ddf5d4a1804982832f58ec2574a --- TESTING.rst | 28 +++++++++++++++++++++------- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/TESTING.rst b/TESTING.rst index 7e7b43d0696..803d5ccd1b2 100644 --- a/TESTING.rst +++ b/TESTING.rst @@ -574,16 +574,30 @@ namespace of the test machine is available for its usage. API & Scenario Tests ~~~~~~~~~~~~~~~~~~~~ -To run the api or scenario tests, deploy Tempest and Neutron with DevStack and -then run the following command, from the tempest directory: :: +To run the api or scenario tests, deploy Tempest, neutron-tempest-plugin +and Neutron with DevStack and then run the following command, +from the tempest directory: :: - tox -e all-plugin + $ export DEVSTACK_GATE_TEMPEST_REGEX="neutron" + $ tox -e all-plugin $DEVSTACK_GATE_TEMPEST_REGEX -If you want to limit the amount of tests that you would like to run, you -can do, for instance: :: +If you want to limit the amount of tests, or run an individual test, +you can do, for instance: :: - export DEVSTACK_GATE_TEMPEST_REGEX="" # e.g. "neutron" - tox -e all-plugin $DEVSTACK_GATE_TEMPEST_REGEX + $ tox -e all-plugin neutron_tempest_plugin.api.admin.test_routers_ha + $ tox -e all-plugin neutron_tempest_plugin.api.test_qos.QosTestJSON.test_create_policy + +If you want to use special config for Neutron, like use advanced images (Ubuntu +or CentOS) testing advanced features, you may need to add config +in tempest/etc/tempest.conf: + +.. code-block:: ini + + [neutron_plugin_options] + image_is_advanced = True + +The Neutron tempest plugin configs are under ``neutron_plugin_options`` scope +of ``tempest.conf``. Running Individual Tests ~~~~~~~~~~~~~~~~~~~~~~~~