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.
Exercising the Services Using Devstack session at Developer
Run the test¶
max_microversion:[container_service] min_microversion=1.26 max_microversion=1.26
You might need to modify the min/max microversion based on your test environment.
Navigate to tempest directory:
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