neutron-lbaas/neutron_lbaas/tests/tempest/README.rst
Shuquan Huang 0cecf3ef77 Openstack typo
According to the word choice convention in
"http://docs.openstack.org/contributor-guide/writing-style/
word-choice.html"
We should use OpenStack instead of Openstack.

Change-Id: Ifc68e07b8c8f53e8c9ab982413eb94b3190b067f
Closes-bug: #1516634
2015-11-25 11:17:42 +08:00

57 lines
1.7 KiB
ReStructuredText

Welcome!
========
This contains the Tempest testing code for the Neutron Load Balancer as a
Service (LBaaS) service. The tests currently require Tempest to be installed
with a working devstack instance. It is assumed that you also have Neutron
with the Neutron LBaaS service installed.
Please see ``/neutron-lbaas/devstack/README.md`` for the required
devstack configuration settings for Neutron-LBaaS.
API and SCENARIO Testing with Tempest:
--------------------------------------
Included in the repo are Tempest tests. If you are familiar with the Tempest
Testing Framework continue on, otherwise please see the
Tempest README :
https://github.com/openstack/tempest/blob/master/README.rst
1. Using Devstack
^^^^^^^^^^^^^^^^^
If you have a running devstack environment, tempest will be automatically
configured and placed in ``/opt/stack/tempest``. It will have a configuration
file, tempest.conf, already set up to work with your devstack installation.
Tests can be run in the following way but you need to have devstack running
for apiv1 tests ::
$> tox -e apiv1
for apiv2 tests ::
$> tox -e apiv2
for scenario tests ::
$> tox -e scenario
2. Not using Devstack
^^^^^^^^^^^^^^^^^^^^^
6/19/2015 - As we do not have an external OpenStack environment with
Neutron_LBaaS V2 to test with, this is TBD
3. Packages tempest vs. tempest-lib
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
As of 6/19/2015, tests are being migrated to tempest-lib, and while both
that library and these tests are in-progress, a specific subset of tempest
is also included in this repo at neutron_lbaas/tests/tempest/lib.
External Resources:
===================
For more information on the Tempest testing framework see:
<https://github.com/openstack/tempest>