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.


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

Edit /opt/stack/tempest/etc/tempest.conf:

  • Add the [container_service] section, configure min_microversion and max_microversion:



You might need to modify the min/max microversion based on your test environment.

Navigate to tempest directory:

cd /opt/stack/tempest

Run this command:

tempest run --regex zun_tempest_plugin.tests.tempest.api

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

tempest run --regex zun_tempest_plugin.tests.tempest.api.test_containers.TestContainer.test_list_containers