27b2222a3d
* The document is no longer only for developers, so the title of the top page is updated. * In the current document standard, docs for contributors are placed under contributor/. * Title levels are rearranged to be shown appropriately with openstackdocsthems. * Fixes many sphinx code-block for better rendering. Change-Id: I36fc80d1c1e5382597099b86df3bbf009ce06902
73 lines
2.1 KiB
ReStructuredText
73 lines
2.1 KiB
ReStructuredText
====================
|
|
VPNaaS Tempest Tests
|
|
====================
|
|
|
|
This contains the tempest test codes for the Neutron VPN as a Service (VPNaaS) service. The tests
|
|
currently require tempest to be installed via devstack or standalone. It is assumed that you
|
|
also have Neutron with the Neutron VPNaaS service installed. These tests could also be run against
|
|
a multinode openstack.
|
|
|
|
Please see /neutron-vpnaas/devstack/README.md for the required devstack configuration settings
|
|
for Neutron-VPNaaS.
|
|
|
|
How to test:
|
|
============
|
|
|
|
As a tempest plugin, the steps to run tests by hands are:
|
|
|
|
1. Setup a local working environment for running tempest.
|
|
|
|
.. code-block:: console
|
|
|
|
tempest init ${your_tempest_dir}
|
|
|
|
2. Enter ${your_tempest_dir}:
|
|
|
|
.. code-block:: console
|
|
|
|
cd ${your_tempest_dir}
|
|
|
|
3. Check neutron_vpnaas_tests exist in tempest plugins.
|
|
|
|
.. code-block:: console
|
|
|
|
tempest list-plugins
|
|
|
|
+----------------------+------------------------------------------------------+
|
|
| Name | EntryPoint |
|
|
+----------------------+------------------------------------------------------+
|
|
| neutron_tests | neutron_tempest_plugin.plugin:NeutronTempestPlugin |
|
|
| neutron_vpnaas_tests | neutron_vpnaas.tests.tempest.plugin:VPNTempestPlugin |
|
|
+----------------------+------------------------------------------------------+
|
|
|
|
4. Run neutron_vpnaas tests.
|
|
|
|
.. code-block:: console
|
|
|
|
tempest run --regex "^neutron_vpnaas.tests.tempest.api\."
|
|
|
|
Usage in gate
|
|
=============
|
|
|
|
In the jenkins gate, devstack-gate/devstack-vm-gate-wrap.sh will invoke tempest with proper
|
|
configurations, such as:
|
|
|
|
.. code-block:: none
|
|
|
|
DEVSTACK_GATE_TEMPEST=1
|
|
DEVSTACK_GATE_TEMPEST_ALL_PLUGINS=1
|
|
DEVSTACK_GATE_TEMPEST_REGEX="^neutron_vpnaas.tests.tempest.api\."
|
|
|
|
The actual raw command in gate running under the tempest code directory is:
|
|
|
|
.. code-block:: console
|
|
|
|
tox -eall-plugin -- "^neutron_vpnaas.tests.tempest.api\."
|
|
|
|
|
|
External Resources
|
|
==================
|
|
|
|
For more information on the tempest,
|
|
see: https://docs.openstack.org/tempest/latest/.
|