This patch updates the README file to have instructions for running the tempest tests using the "all" environment instead of "all-plugins". The "all-plugins" environment has been deprecated for years and uses site-packages, which may cause unintended test scenarios. Change-Id: I297babd2e97ad146f60f32ae9073e47a62973860
57 lines
1.7 KiB
ReStructuredText
57 lines
1.7 KiB
ReStructuredText
======================
|
|
Octavia Tempest Plugin
|
|
======================
|
|
|
|
Team and repository tags
|
|
========================
|
|
|
|
.. image:: https://governance.openstack.org/tc/badges/octavia-tempest-plugin.svg
|
|
:target: https://governance.openstack.org/tc/reference/tags/index.html
|
|
|
|
.. Change things from this point on
|
|
|
|
Tempest integration of Octavia
|
|
==============================
|
|
|
|
This project contains the Tempest plugin for the Octavia project for
|
|
OpenStack Load Balancing.
|
|
|
|
For more information about Octavia see:
|
|
https://docs.openstack.org/octavia/latest/
|
|
|
|
For more information about Tempest plugins see:
|
|
https://docs.openstack.org/tempest/latest/plugin.html
|
|
|
|
* Free software: Apache license
|
|
* Documentation: https://docs.openstack.org/octavia-tempest-plugin/latest/
|
|
* Source: https://opendev.org/openstack/octavia-tempest-plugin
|
|
* Bugs: https://storyboard.openstack.org/#!/project/openstack/octavia-tempest-plugin
|
|
|
|
Installing
|
|
----------
|
|
|
|
From the tempest directory, setup the tempest virtual environment for the
|
|
Octavia tempest plugin::
|
|
|
|
$ tox -e venv-tempest -- pip3 install -e <path to octavia-tempest-plugin>
|
|
|
|
For example, when using a typical devstack setup::
|
|
|
|
$ cd /opt/stack/tempest
|
|
$ tox -e venv-tempest -- pip3 install -e /opt/stack/octavia-tempest-plugin
|
|
|
|
Running the tests
|
|
-----------------
|
|
|
|
To run all the tests from this plugin, call from the tempest repo::
|
|
|
|
$ tox -e all -- octavia_tempest_plugin
|
|
|
|
To run a single test case, call with full path, for example::
|
|
|
|
$ tox -e all -- octavia_tempest_plugin.tests.scenario.v2.test_traffic_ops.TrafficOperationsScenarioTest.test_basic_traffic
|
|
|
|
To retrieve a list of all tempest tests, run::
|
|
|
|
$ testr list-tests
|