zun/doc/source/contributor/tempest-tests.rst
Hongbin Lu 3c564d2587 Document how to run specific tempest test
Change-Id: Id20807da3f36ed00ecbe8c7bb94fe601b7ebf70b
2018-03-25 20:26:24 +00:00

1.8 KiB

Run tempest tests locally

This is a guide for developers who want to run tempest tests in their local machine.

Zun contains a suite of tempest tests in the zun/tests/tempest directory. Tempest tests are primary for testing integration between Zun and its depending software stack (i.e. Docker, other OpenStack services). Any proposed code change will be automatically rejected by the gate if the change causes tempest test failures. If this happens, contributors are suggested to refer this document to re-run the tests locally and perform any necessary trouble-shooting.

Prerequisite

You need to deploy Zun in a devstack environment.

Refer the Exercising the Services Using Devstack session at Developer Quick-Start Guide for details.

Run the test

Navigate to tempest directory:

cd /opt/stack/tempest

Run this command:

tox -eall-plugin -- zun_tempest_plugin.tests.tempest.api

To run a single test case, run with the test case name, for example:

tox -e all-plugin -- zun_tempest_plugin.tests.tempest.api.test_containers.TestContainer.test_list_containers