x/vmware-nsx

History

Devang Doshi 2f7850f3c0 Tempest: Added new design for tempest test cases - Added appliance manager to deploy, maintain, update and clean topology appliances for test modules - Added traffic manager to define network related traffic functions - Added feature manager to CRUD feature related tasks - Rewrote test_micro_segmentation_ops.py based on new design - Rewrote L2gaeway nsxv3 tests based on new design - Added L2gateway nsxv3 scenario tests based on new design Change-Id: I571a9dede56266204efd36ad2720340e7128fd79		2017-07-14 10:50:40 -07:00
..
common	Tempest: Added new design for tempest test cases	2017-07-14 10:50:40 -07:00
doc	Tempest: admin-policy scenario basic operation test	2017-03-05 11:34:48 +00:00
lib	Tempest: Added new design for tempest test cases	2017-07-14 10:50:40 -07:00
services	Tempest: Added new design for tempest test cases	2017-07-14 10:50:40 -07:00
tests	Tempest: Added new design for tempest test cases	2017-07-14 10:50:40 -07:00
__init__.py	Fixes vmware_nsx_tempest tempest plugin issues with tempest	2017-05-17 10:24:53 +00:00
_i18n.py	Drop log translations	2017-03-26 05:09:02 -07:00
config.py	Tempest: Added new design for tempest test cases	2017-07-14 10:50:40 -07:00
plugin.py	Fixes vmware_nsx_tempest tempest plugin issues with tempest	2017-05-17 10:24:53 +00:00
README.rst	Removing irrelevant note in README file	2017-03-29 10:54:05 +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:

https://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:

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
```

Install virtualenv with the following command:

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

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

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

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

Validate installed vmware_nsx_tempest successfully 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:

import vmware_nsx.shell.admin.plugins.common.utils as admin_utils