Hongbin Lu 4fbc34d47a Add a note on setting api version

In order to run the tempest test correctly, we need to specify
the API version based on a specific setup. Add a note on the
document to clarify that.

Change-Id: I1ccf00b49433550cfbd6adceb8ac661e5ec1e5f3

2018-10-31 03:59:11 +00:00

2.2 KiB

Raw Blame History

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

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

Add the [container_service] section, configure min_microversion and max_microversion:
[container_service]
min_microversion=1.26
max_microversion=1.26
Note

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:

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

2.2 KiB Raw Blame History

Run tempest tests locally

Prerequisite

Run the test

2.2 KiB

Raw Blame History