openstack/neutron-vpnaas
Code Issues Proposed changes
master
neutron-vpnaas/doc/source/contributor/vpnaas-rally-test.rst
Akihiro Motoki 27b2222a3d Rearrange doc structure to standard layout 
* The document is no longer only for developers, so the title of
  the top page is updated.
* In the current document standard, docs for contributors are
  placed under contributor/.
* Title levels are rearranged to be shown appropriately
  with openstackdocsthems.
* Fixes many sphinx code-block for better rendering.

Change-Id: I36fc80d1c1e5382597099b86df3bbf009ce06902
2018-02-28 20:49:23 +09:00

2.9 KiB
Raw Permalink Blame History

VPNaaS Rally Tests

This contains the rally test codes for the Neutron VPN as a Service (VPNaaS) service. The tests currently require rally to be installed via devstack or standalone. It is assumed that you also have Neutron with the Neutron VPNaaS service installed.

These tests could also be run against a multinode openstack.

Please see /neutron-vpnaas/devstack/README.md for the required devstack configuration settings for Neutron-VPNaaS.

Structure

  1. plugins - Directory where you can add rally plugins. Almost everything in Rally is a plugin. Contains base, common methods and actual scenario tests
  2. rally-configs - Contains input configurations for the scenario tests

How to test

Included in the repo are rally tests. For information on rally, please see the rally README.

Create a rally deployment for your cloud and make sure it is active.

rally deployment create --file=cloud_cred.json --name=MyCloud

You can also create a rally deployment from the environment variables.

rally deployment create --fromenv --name=MyCloud

Create a folder structure as below

sudo mkdir /opt/rally

Create a symbolic link to the plugins directory

cd /opt/rally
sudo ln -s /opt/stack/neutron-vpnaas/rally-jobs/plugins

Run the tests. You can run the tests in various combinations.

  • Single Node with DVR with admin credentials
  • Single Node with DVR with non admin credentials
  • Multi Node with DVR with admin credentials
  • Multi Node with DVR with non admin credentials
  • Single Node, Non DVR with admin credentials
  • Multi Node, Non DVR with admin credentials

Create a args.json file with the correct credentials depending on whether it is a single node or multinode cloud. A args_template.json file is available at /opt/stack/neutron-vpnaas/rally-jobs/rally-configs/args_template.json for your reference.

Update the rally_config_dvr.yaml or rally_config_non_dvr.yaml file to change the admin/non_admin credentials.

Use the appropriate config files to run either dvr or non_dvr tests.

With DVR:

rally task start \
  /opt/stack/neutron-vpnaas/rally-jobs/rally-configs/rally_config_dvr.yaml \
  --task-args-file /opt/stack/neutron-vpnaas/rally-jobs/rally-configs/args.json

Non DVR:

rally task start \
  /opt/stack/neutron-vpnaas/rally-jobs/rally-configs/rally_config_non_dvr.yaml \
 --task-args-file /opt/stack/neutron-vpnaas/rally-jobs/rally-configs/args.json

Note

Non DVR scenario can only be run as admin as you need admin credentials to create a non DVR router.

External Resources

For more information on the rally testing framework see: https://github.com/openstack/rally/.