A Tempest plugin to test Neutron VMware NSX plugin.
Go to file
Boden R 31e981d236 setup project for pypi releases
The intent of this patch is to update the vmware-nsx-tempest-plugin
project so that it's capable of being published to PYPI. To do so
the doc requirements are separated from test-requirements, tox.ini is
updated in a few places and .gitignore file is included for good
measure.

Also see https://review.openstack.org/#/c/584498/

Change-Id: If02713fd427613433f554272c9962e0ebb95b1d6
2018-07-31 09:09:52 -06:00
doc setup project for pypi releases 2018-07-31 09:09:52 -06:00
releasenotes Tempest: 1st patch after using cookiecutter to split in-tree project 2017-07-24 22:20:24 +00:00
vmware_nsx_tempest setup project for pypi releases 2018-07-31 09:09:52 -06:00
.gitignore setup project for pypi releases 2018-07-31 09:09:52 -06:00
.gitreview Tempest: Renamed folder based on the need. 2017-07-28 12:11:15 -07:00
.stestr.conf Switch to stestr 2018-07-04 13:44:02 +07:00
.testr.conf Tempest: Renamed folder based on the need. 2017-07-28 12:11:15 -07:00
CONTRIBUTING.rst Tempest: 1st patch after using cookiecutter to split in-tree project 2017-07-24 22:20:24 +00:00
HACKING.rst Tempest: 1st patch after using cookiecutter to split in-tree project 2017-07-24 22:20:24 +00:00
LICENSE Tempest: 1st patch after using cookiecutter to split in-tree project 2017-07-24 22:20:24 +00:00
README.rst Tempest: Renamed folder based on the need. 2017-07-28 12:11:15 -07:00
babel.cfg Tempest: 1st patch after using cookiecutter to split in-tree project 2017-07-24 22:20:24 +00:00
requirements.txt Updated from global requirements 2018-06-17 10:41:00 +00:00
setup.cfg Tempest: Renamed folder based on the need. 2017-07-28 12:11:15 -07:00
setup.py Updated from global requirements 2018-06-17 10:41:00 +00:00
test-requirements.txt setup project for pypi releases 2018-07-31 09:09:52 -06:00
tox.ini setup project for pypi releases 2018-07-31 09:09:52 -06:00

README.rst

Welcome!

vmware-nsx-tempest-plugin

Tempest plugin vmware-nsx-tempest-plugin

This repo hosts vmware-nsx's functional api and scenario tests.

vmware-nsx is Vmware plugin for neutron. This repo is tempest plugin to test vmware-nsx at function level. All vmware-nsx-tempest-plugin tests are in "master" branch. Some of the tests are designed based on N-S traffic. Intstall thsi repo on external VM to run entire test suite.

Features:

  • API tests
  • Scenario tests

Overview:

Installation:

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

    $ cd /opt/stack
    $ git clone https://github.com/openstack/tempest
  2. Install virtualenv with the following command:

    $ cd /opt/stack/tempest
    $ ./run_tempest.sh -u not_exist_tests
  3. Install vmware-nsx-tempest-plugin master branch at /opt/stack:

    $ cd /opt/stack
    $ git clone https://github.com/openstack/vmware-nsx-tempest-plugin.git
  4. Install vmware-nsx-tempest-plugin in your tempest development environment:

    $ cd /opt/stack
    $ sudo pip install -e vmware-nsx-tempest-plugin

    Run command:

    $ pip show vmware-nsx-tempest-plugin

    You should observe the following statements:

    Location: /opt/stack/vmware-nsx-tempest-plugin
  5. Validate installed vmware_nsx_tempest successfully do:

    $ cd /opt/stack/vmware-nsx-tempest-plugin
    $ ostestr -l vmware_nsx_tempest
    $ ostestr vmware_nsx_tempest.tests.nsxv3.scenario.test_mdproxy.TestMDProxy.test_mdproxy_ping
    $ python -m testtools.run vmware_nsx_tempest.tests.nsxv3.scenario.test_mdproxy.TestMDProxy.test_mdproxy_ping

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/stack/tempest
$ ostestr vmware_nsx_tempest.*test_l2_gateway
$ ostestr vmware_nsx_tempest.tests.nsxv.api.test_l2_gateway_connection.L2GatewayConnectionTest.test_csuld_single_device_interface_vlan

TechNote on vmware-nsx-tempest-plugin:

vmware-nsx-tempest-plugin 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 will not work, unless vmware-nsx is installed in your tempest environment:

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