5.0 KiB

Raw Blame History

Introduction

The Monasca Tempest Tests use the OpenStack Tempest Plugin Interface. This README describes how to configure and run them using a variety of methods. Currently monasca-vagrant is used to run tests. This document will be updated when switch the environment to DevStack.

Configuring to run the Monasca Tempest Tests

Clone the OpenStack Tempest repo, and cd to it.

git clone https://github.com/openstack/tempest.git
cd tempest

Create a virtualenv for running the Tempest tests and activate it. For example in the Tempest root dir
```
virtualenv .venv
source .venv/bin/activate
```

Install the Tempest requirements in the virtualenv.

pip install -r requirements.txt -r test-requirements.txt
pip install nose

Create etc/tempest.conf and etc/logging.conf in the Tempest root dir. I believe the file etc/tempest.conf.sample can be copied to etc/tempest.conf. Similarly for logging.conf. Add the following sections to tempest.conf for testing using the monasca-vagrant environment.

[identity]

username = mini-mon
password = password
tenant_name = mini-mon
domain_name = default
admin_username = admin
admin_password = admin
admin_domain_name = default
admin_tenant_name = admin
alt_username = mini-mon
alt_password = password
alt_tenant_name = mini-mon
use_ssl = False
auth_version = v3
uri = http://192.168.10.5:5000/v2.0/
uri_v3 = http://192.168.10.5:35357/v3/

[auth]

allow_tenant_isolation = true
tempest_roles = monasca-user

Clone the monasca-api repo.
Install the monasca-api in your venv, which will also register the Monasca Tempest Plugin as, monasca_tests.
```
python setup.py install
```

See the OpenStack Tempest Plugin Interface, for more details on Tempest Plugins and the plugin registration process.

Running the Monasca Tempest Tests

The Monasca Tempest Tests can be run using a variety of methods including:

Testr
Os-testr
[PyCharm](Os-testr

Run the tests from the CLI using testr

Testr is a test runner that can be used to run the Tempest tests.

In the Tempest root dir, create a list of the Monasca Tempest Tests in a file.
```
testr list-tests monasca_tempest_tests > monasca_tempest_tests
```

Run the tests using testr

testr run --load-list=monasca_tempest_tests

You can also use testr to create a list of specific tests for your needs.

Run the tests from the CLI using os-testr (no file necessary)

Os-testr is a test wrapper that can be used to run the Monasca Tempest tests. In the Tempest root dir: ostestr --regex monasca_tempest_tests

Running/Debugging the Monasca Tempest Tests in PyCharm

Assuming that you have already created a PyCharm project for the monasca-api do the following:

In PyCharm, Edit Configurations and add a new Python tests configuration by selecting Python tests->Nosetests.
Name the test. For example TestVersions.
Set the path to the script with the tests to run. For example, ~/repos/monasca-api/monasca_tempest_tests/api/test_versions.py
Set the name of the Class to test. For example TestVersions.
Set the working directory to your local root Tempest repo. For example, ~/repos/tempest.
Select the Python interpreter for your project to be the same as the one virtualenv created above. For example, ~/repos/tempest/.venv
Run the tests. You should also be able to debug them.
Step and repeat for other tests.

References

This section provides a few additional references that might be useful:

In addition to the above references, another source of information is the following OpenStack projects:

Manila Tempest Tests
Congress Tempest Tests. In particular, the Manila Tempest Tests were used as a reference implementation to develop the Monasca Tempest Tests. There is also a wiki HOWTO use tempest with manila that might be useful for Monasca too.

Issues

Update documentation for testing using Devstack when available.
Consider changing from monasca_tempest_tests to monasca_api_tempest_tests.

5.0 KiB Raw Blame History