4fbc34d47a
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
68 lines
2.2 KiB
ReStructuredText
68 lines
2.2 KiB
ReStructuredText
..
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
not use this file except in compliance with the License. You may obtain
|
|
a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
License for the specific language governing permissions and limitations
|
|
under the License.
|
|
|
|
=========================
|
|
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 <https://docs.openstack.org/zun/latest/contributor/quickstart.html#exercising-the-services-using-devstack>`_
|
|
for details.
|
|
|
|
Run the test
|
|
============
|
|
|
|
Edit ``/opt/stack/tempest/etc/tempest.conf``:
|
|
|
|
* Add the ``[container_service]`` section,
|
|
configure ``min_microversion`` and ``max_microversion``:
|
|
|
|
.. code-block:: ini
|
|
|
|
[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
|