x/vmware-nsx
Code Issues Proposed changes
vmware-nsx/vmware_nsx_tempest
History
ghanshyam ec41e9b0f3 Fix baremetal config options in Tempest plugin 
Below patch remove the baremetal tests and its configuration
from Tempest tree
 - Id518a6d87d0949737cd1c50cb6a83149b85e5f85

Which remove the baremetal config options 'driver_enabled'
also from Tempest config but this options is used by other
Tempest plugin like-
- openstack/vmware-nsx
- openstack/networking-fo- rtinet
http://codesearch.openstack.org/?q=CONF.baremetal&i=nope&files=&repos=

Patch Iad6e16c28cf2a35cc6bf040f57224d32c085b7bc moved all
baremetal config option to Ironic Tempest plugin but did not
move the 'driver_enabled' config options.

So it break the compatibility bits of config options.

Patch I1ba580bd1f4beb1c5825b29995f10828f1eb1c44 add 'driver_enabled'
in Ironic plugin with deprecated for removal so that tempest plugin
does not get break.

But instead of using 'driver_enabled' we should use new config
options introduced by Id518a6d87d0949737cd1c50cb6a83149b85e5f85

Change-Id: I04d9af40dbe884df7d562269ea0f98a6fe61544c
Depends-On: Id518a6d87d0949737cd1c50cb6a83149b85e5f85
2016-12-20 14:27:13 +00:00
..
common
Tempest: Added MDProxy scenario test cases
2016-12-16 10:49:31 -08:00
doc
tempest: lbaas l7 switching scenario tests
2016-10-18 13:12:28 +00:00
services
Tempest: Added MDProxy scenario test cases
2016-12-16 10:49:31 -08:00
tests
Fix baremetal config options in Tempest plugin
2016-12-20 14:27:13 +00:00
__init__.py
init release of vmware-nsx tempest tests in tempest external plugin
2016-01-21 10:02:00 -08:00
_i18n.py
init release of vmware-nsx tempest tests in tempest external plugin
2016-01-21 10:02:00 -08:00
config.py
Tempest: Added MDProxy scenario test cases
2016-12-16 10:49:31 -08:00
plugin.py
Fix tempest.conf generation
2016-08-23 15:01:20 +05:30
README.rst
Tempest: Format vmware_nsx_tempest README
2016-05-20 17:04:27 +00:00

README.rst

Welcome!

vmware_nsx_tempest is a plugin module to openstack tempest project.

If you are not familiar with tempest, please refer to:

http://docs.openstack.org/developer/tempest

It is implemented with tempest external plugin. The official design sepcification is at:

https://review.openstack.org/#/c/184992/

Overview

vmware_nsx_tempest hosts vmware_nsx's functional api and scenario tests.

All vmware_nsx_tempest tests are in "master" branch. For this reason, it is recommended to have your own developer version of vmware-nsx repo installed outside the devstack folder, /opt/stack/.

For example at /opt/devtest folder. In doing so, you can install editable vmware-nsx repo under tempest VENV environemnt.

Installation:

  1. On your own development folder, for example /opt/devtest/, install your own tempest development env at /opt/devtest/os-tempest/:

    $ cd /opt/devtest
$ git clone https://github.com/openstack/tempest os-tempest

  2. Install virtualenv with the following command:

    $ cd /opt/devtest/os-tempest
$ ./run_tempest.sh -u not_exist_tests

  3. Install vmware-nsx master branch at /opt/devtest/vmware-nsx:

    $ cd /opt/devtest
$ git clone https://github.com/openstack/vmware-nsx

  4. Install vmware_nsx_tempest in your tempest development environment:

    $ cd /opt/devtest/os-tempest
$ source .venv/bin/activate
$ pip install -e /opt/devtest/vmware-nsx/

    Run command:

    $ pip show vmware-nsx

    You should observe the following statements:

    Location: /opt/devtest/vmware-nsx

    and under section of Entry-points:

    [tempest.test_plugins]
vmware-nsx-tempest-plugin = vmware_nsx_tempest.plugin:VMwareNsxTempestPlugin

  5. Validate installed vmware_nsx_tempest succesfully do:

    $ cd /opt/devtest/os-tempest
$ tools/with_venv.sh testr list-tests vmware_nsx_tempest.*l2_gateway

Your installation failed, if no tests are shown.

Execution:

vmware_nsx_tempest tests are tempest tests, you need to run from tempest directory. For example, to run only l2-gateway tests:

$ cd /opt/devtest/os-tempest
$ ./run_tempest.sh -t vmware_nsx_tempest.*test_l2_gateway
$ ./run_tempest.sh -d vmware_nsx_tempest.tests.nsxv.api.test_l2_gateway_connection.L2GatewayConnectionTest.test_csuld_single_device_interface_vlan

TechNote on vmware_nsx_tempest:

vmware_nsx_tempest is a plugin to tempest, not neutron, nor vmware_nsx.

It is defined by tempest.test_plugins.

Modules within vmware_nsx_tempest can not see resources defined by vmware_nsx. Commands like following are not acceptable, unless vmware_nsx is installed in your tempest environment:

from vmware_nsx._i18n import _LE
import vmware_nsx.shell.admin.plugins.common.utils as admin_utils

TechNote on logging:

tempest repo itself does not enforce LOG complying to _i18n. So for tempest tests for vmware-nsx, that is vmware_nsx_tempest, use LOG.debug() command.

However, if you need to log other than debug level, please do:

from vmware_nsx_tempest._i18n import _LI
from vmware_nsx_tempest._i18n import _LE
from vmware_nsx_tempest._i18n import _LW

Customize it depending on the log level your scripts will use.