VMware-NSX: update documentation to reference VMware-NSX

Change files copied from Neutron to have the VMware NSX references.

Change-Id: I3cf8b3d37e045cb8efb0cac31efa30b93cc88d09
This commit is contained in:
Gary Kotton 2014-12-29 00:38:31 -08:00
parent b2c391c2c3
commit 0c3177235e
4 changed files with 25 additions and 44 deletions

View File

@ -13,4 +13,4 @@ Pull requests submitted through GitHub will be ignored.
Bugs should be filed on Launchpad, not GitHub: Bugs should be filed on Launchpad, not GitHub:
https://bugs.launchpad.net/neutron https://bugs.launchpad.net/vmware-nsx

View File

@ -1,12 +1,12 @@
Neutron Style Commandments VMware-NSX Style Commandments
======================= =============================
- Step 1: Read the OpenStack Style Commandments - Step 1: Read the OpenStack Style Commandments
http://docs.openstack.org/developer/hacking/ http://docs.openstack.org/developer/hacking/
- Step 2: Read on - Step 2: Read on
Neutron Specific Commandments VMware-NSX Specific Commandments
-------------------------- --------------------------------
- [N319] Validate that debug level logs are not translated - [N319] Validate that debug level logs are not translated
- [N320] Validate that LOG messages, except debug ones, have translations - [N320] Validate that LOG messages, except debug ones, have translations

View File

@ -1,30 +1,17 @@
Welcome! Welcome!
======== ========
You have come across a cloud computing network fabric controller. It has You have come across the VMware-NSX family of driver for Neutron.
identified itself as "Neutron." It aims to tame your (cloud) networking!
External Resources: External Resources:
=================== ===================
The homepage for Neutron is: http://launchpad.net/neutron. Use this The homepage for VMware-NSX is: http://launchpad.net/vmware-nsx. Use this
site for asking for help, and filing bugs. Code is available on site for asking for help, and filing bugs. Code is available on
git.openstack.org at <http://git.openstack.org/cgit/openstack/neutron>. git.openstack.org at <https://github.com/stackforge/vmware-nsx>.
The latest and most in-depth documentation on how to use Neutron is For help on usage and hacking of VMware-NSX, please send mail to
available at: <http://docs.openstack.org>. This includes:
Neutron Administrator Guide
http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html
Neutron API Reference:
http://docs.openstack.org/api/openstack-network/2.0/content/
Current Neutron developer documentation is available at:
http://wiki.openstack.org/NeutronDevelopment
For help on usage and hacking of Neutron, please send mail to
<mailto:openstack-dev@lists.openstack.org>. <mailto:openstack-dev@lists.openstack.org>.
For information on how to contribute to Neutron, please see the For information on how to contribute to VMware-NSX, please see the
contents of the CONTRIBUTING.rst file. contents of the CONTRIBUTING.rst file.

View File

@ -1,19 +1,13 @@
Testing Neutron Testing VMware-NSX
============================================================= ==================
Overview Overview
-------- --------
The unit tests (neutron/test/unit/) are meant to cover as much code as The unit tests (vmware_nsx/neutron/test/unit/) are meant to cover as much
possible and should be executed without the service running. They are code as possible and should be executed without the service running. They
designed to test the various pieces of the neutron tree to make sure are designed to test the various pieces of the neutron and VMware NSX tree
any new changes don't break existing functionality. to make sure any new changes don't break existing functionality.
The functional tests (neutron/tests/functional/) are intended to
validate actual system interaction. Mocks should be used sparingly,
if at all. Care should be taken to ensure that existing system
resources are not modified and that resources created in tests are
properly cleaned up.
Development process Development process
------------------- -------------------
@ -85,12 +79,12 @@ interactive debugging session while using testr.
With `tox` With `tox`
~~~~~~~~~~ ~~~~~~~~~~
Neutron, like other OpenStack projects, uses `tox`_ for managing the virtual VMware NSX, like other OpenStack projects, uses `tox`_ for managing the virtual
environments for running test cases. It uses `Testr`_ for managing the running environments for running test cases. It uses `Testr`_ for managing the running
of the test cases. of the test cases.
Tox handles the creation of a series of `virtualenvs`_ that target specific Tox handles the creation of a series of `virtualenvs`_ that target specific
versions of Python (2.6, 2.7, 3.3, etc). versions of Python (2.7, 3.3, etc).
Testr handles the parallel execution of series of test cases as well as Testr handles the parallel execution of series of test cases as well as
the tracking of long-running tests and other things. the tracking of long-running tests and other things.
@ -130,19 +124,19 @@ the dot-separated path to the module you want as an argument to it.
For executing a specific test case, specify the name of the test case For executing a specific test case, specify the name of the test case
class separating it from the module path with a colon. class separating it from the module path with a colon.
For example, the following would run only the JSONV2TestCase tests from For example, the following would run only the TestSubnetsV2 tests from
neutron/tests/unit/test_api_v2.py:: vmware_nsx/neutron/tests/unit/vmware/test_nsx_v_plugin.py::
$ ./run_tests.sh neutron.tests.unit.test_api_v2.JSONV2TestCase $ ./run_tests.sh vmware_nsx.neutron.tests.unit.vmware.test_nsx_v_plugin.TestSubnetsV2
or:: or::
$ tox -e py27 neutron.tests.unit.test_api_v2.JSONV2TestCase $ tox -e py27 vmware_nsx.neutron.tests.unit.vmware.test_nsx_v_plugin.TestSubnetsV2
Adding more tests Adding more tests
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
Neutron has a fast growing code base and there is plenty of areas that VMware NSX has a fast growing code base and there is plenty of areas that
need to be covered by unit and functional tests. need to be covered by unit and functional tests.
To get a grasp of the areas where tests are needed, you can check To get a grasp of the areas where tests are needed, you can check
@ -169,7 +163,7 @@ after a tox run and reused for debugging::
$ . .tox/venv/bin/activate $ . .tox/venv/bin/activate
$ python -m testtools.run [test module path] $ python -m testtools.run [test module path]
Tox packages and installs the neutron source tree in a given venv Tox packages and installs the vmware-nsx source tree in a given venv
on every invocation, but if modifications need to be made between on every invocation, but if modifications need to be made between
invocation (e.g. adding more pdb statements), it is recommended invocation (e.g. adding more pdb statements), it is recommended
that the source tree be installed in the venv in editable mode:: that the source tree be installed in the venv in editable mode::