Tempest Plugin for Monasca project
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ethan Apodaca 46a97d9c52 Update alarms count tests 2 weeks ago
clients Add tests for events 1 month ago
contrib Migrate to Zuul v3 1 year ago
services Add tests for events 1 month ago
tests Update alarms count tests 1 week ago
README.md Update the documentation link for doc migration 1 year ago
__init__.py Add Monasca Tempest Tests 3 years ago
config.py Make rejectable_message_size configurable for log-api tests 2 months ago
plugin.py Merged monasca log api tempest plugin into monasca tempest plugin 1 year ago



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 the devstack environment is needed to run the tests. Instructions on setting up a devstack environment can be found here: https://github.com/openstack/monasca-api/devstack/README.md.

Configuring to run the Monasca Tempest Tests

  1. Clone the OpenStack Tempest repo, and cd to it.
   git clone https://git.openstack.org/openstack/tempest.git
   cd tempest
  1. Create a virtualenv for running the Tempest tests and activate it. For example in the Tempest root dir

    virtualenv .venv
    source .venv/bin/activate
  2. Install the Tempest requirements in the virtualenv.

    pip install -r requirements.txt -r test-requirements.txt
  3. Create etc/tempest.conf in the Tempest root dir by running the following command:

    oslo-config-generator --config-file tempest/cmd/config-generator.tempest.conf  --output-file etc/tempest.conf

    Add the following sections to tempest.conf for testing using the devstack environment.

    auth_version = v3
    uri =
    uri_v3 =
    user_lockout_failure_attempts = 2
    user_locakout_duration = 5
    user_unique_last_password_count = 2
    admin_domain_scope = True
    use_dynamic_credentials = True
    admin_project_name = admin
    admin_username = admin
    admin_password = secretadmin
    admin_domain_name = Default

    Edit the variable values in the identity section to match your particular environment.

  4. Create etc/logging.conf in the Tempest root dir by making a copying logging.conf.sample.

  5. Clone the monasca-api repo in a directory somewhere outside of the Tempest root dir.

  6. Install the monasca-api in your venv, which will also register the Monasca Tempest Plugin as, monasca_tests.

cd into the monasca-api root directory. Making sure that the tempest virtual env is still active, run the following command.

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:

  1. Testr
  2. Os-testr
  3. PyCharm
  4. Tempest Scripts in Devstack

Run the tests from the CLI using testr

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

  1. Initializing testr is necessary to set up the .testrepository directory before using it for the first time. In the Tempest root dir:

    testr init
  2. Create a list of the Monasca Tempest Tests in a file:

    testr list-tests monasca_tempest_tests > monasca_tempest_tests
  3. 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 using Tempest Run command

tempest run is a domain-specific command to be used as the primary entry point for running Tempest tests.

  1. In the Tempest root dir:

    tempest run -r monasca_tempest_tests

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.

  1. In the Tempest root dir:

    ostestr --serial --regex monasca_tempest_tests

    --serial option is necessary here. Monasca tempest tests can’t be run in parallel (default option in ostestr) because some tests depend on the same data and will randomly fail.

Running/Debugging the Monasca Tempest Tests in PyCharm

You need to install nose for running tests from PyCharm:

pip install nose

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

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

Run the tests from the CLI using tempest scripts in devstack

  1. Create a virtualenv in devstack for running the tempest tests and activate it:

    cd /opt/stack/tempest
    virtualenv .venv
    source .venv/bin/activate
  2. Install the tempest requirements in the virtualenv:

    pip install -r requirements.txt -r test-requirements.txt
  3. If you want to test changes in monasca-api code on your local machine, change directory to monasca-api and install the latest monasca-api code:

    cd /vagrant_home/<monasca-api directory>
    python setup.py install

    Or if you want to use the current monasca api in devstack:

   cd /opt/stack/monasca-api
   python setup.py install
  1. Run tempest tests:
   cd /opt/stack/tempest
   testr init
   ostestr --serial --regex monasca_tempest_tests


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:


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