| Michael Johnson | 791fefb | 2019-09-13 10:48:05 -0700 | [diff] [blame] | 1 | ====================== |
| 2 | Octavia Tempest Plugin |
| 3 | ====================== |
| 4 | |
| Michael Johnson | 34139b0 | 2017-03-15 10:31:10 -0700 | [diff] [blame] | 5 | Team and repository tags |
| 6 | ======================== |
| 7 | |
| ShangXiao | 4e62028 | 2018-06-13 01:38:21 -0700 | [diff] [blame] | 8 | .. image:: https://governance.openstack.org/tc/badges/octavia-tempest-plugin.svg |
| 9 | :target: https://governance.openstack.org/tc/reference/tags/index.html |
| Michael Johnson | 34139b0 | 2017-03-15 10:31:10 -0700 | [diff] [blame] | 10 | |
| 11 | .. Change things from this point on |
| 12 | |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 13 | Tempest integration of Octavia |
| 14 | ============================== |
| Michael Johnson | 34139b0 | 2017-03-15 10:31:10 -0700 | [diff] [blame] | 15 | |
| 16 | This project contains the Tempest plugin for the Octavia project for |
| 17 | OpenStack Load Balancing. |
| 18 | |
| 19 | For more information about Octavia see: |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 20 | https://docs.openstack.org/octavia/latest/ |
| Michael Johnson | 34139b0 | 2017-03-15 10:31:10 -0700 | [diff] [blame] | 21 | |
| 22 | For more information about Tempest plugins see: |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 23 | https://docs.openstack.org/tempest/latest/plugin.html |
| Michael Johnson | 34139b0 | 2017-03-15 10:31:10 -0700 | [diff] [blame] | 24 | |
| 25 | * Free software: Apache license |
| ShangXiao | 4e62028 | 2018-06-13 01:38:21 -0700 | [diff] [blame] | 26 | * Documentation: https://docs.openstack.org/octavia-tempest-plugin/latest/ |
| caoyuan | 980f5de | 2019-04-23 19:39:04 +0800 | [diff] [blame] | 27 | * Source: https://opendev.org/openstack/octavia-tempest-plugin |
| ShangXiao | 4e62028 | 2018-06-13 01:38:21 -0700 | [diff] [blame] | 28 | * Bugs: https://storyboard.openstack.org/#!/project/openstack/octavia-tempest-plugin |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 29 | |
| 30 | Installing |
| 31 | ---------- |
| 32 | |
| Michael Johnson | 73c703e | 2023-02-28 00:32:21 +0000 | [diff] [blame] | 33 | From the tempest directory, setup the tempest virtual environment for the |
| 34 | Octavia tempest plugin:: |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 35 | |
| Michael Johnson | 73c703e | 2023-02-28 00:32:21 +0000 | [diff] [blame] | 36 | $ tox -e venv-tempest -- pip3 install -e <path to octavia-tempest-plugin> |
| 37 | |
| 38 | For example, when using a typical devstack setup:: |
| 39 | |
| 40 | $ cd /opt/stack/tempest |
| 41 | $ tox -e venv-tempest -- pip3 install -e /opt/stack/octavia-tempest-plugin |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 42 | |
| 43 | Running the tests |
| 44 | ----------------- |
| 45 | |
| 46 | To run all the tests from this plugin, call from the tempest repo:: |
| 47 | |
| Michael Johnson | 73c703e | 2023-02-28 00:32:21 +0000 | [diff] [blame] | 48 | $ tox -e all -- octavia_tempest_plugin |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 49 | |
| 50 | To run a single test case, call with full path, for example:: |
| 51 | |
| Michael Johnson | 73c703e | 2023-02-28 00:32:21 +0000 | [diff] [blame] | 52 | $ tox -e all -- octavia_tempest_plugin.tests.scenario.v2.test_traffic_ops.TrafficOperationsScenarioTest.test_basic_traffic |
| Bar RH | 36ece2d | 2017-12-20 02:15:05 +0200 | [diff] [blame] | 53 | |
| 54 | To retrieve a list of all tempest tests, run:: |
| 55 | |
| 56 | $ testr list-tests |