tempest/roles/run-tempest/README.rst
Sergey Vilgelm 2979bff949
Pass tox_extra_args to Run tempest task
Patrole needs access to global packages, but the 'all-plugin' is
deprecated[0] and 'all' defines a sitepackages option as False[1].
Adding tox_extra_args option makes it possible to configure Zuul and
pass --sitepackages argument to tox.

[0] 9b4c50cf63/tox.ini (L64)
[1] 9b4c50cf63/tox.ini (L7)

Change-Id: Ib3264f54075216471720483c8dd816887c1f413c
2018-11-06 15:33:04 -06:00

70 lines
1.6 KiB
ReStructuredText

Run Tempest
**Role Variables**
.. zuul:rolevar:: devstack_base_dir
:default: /opt/stack
The devstack base directory.
.. zuul:rolevar:: tempest_concurrency
:default: 0
The number of parallel test processes.
.. zuul:rolevar:: tempest_test_regex
:default: ''
A regular expression used to select the tests.
It works only when used with some specific tox environments
('all', 'all-plugin'.)
Multi-line and commented regexs can be achieved by doing this:
::
vars:
tempest_test_regex: |
(?x) # Ignore comments and whitespaces
# Line with only a comment.
(tempest\.(api|scenario|thirdparty)).*$ # Run only api scenario and third party
.. zuul:rolevar:: tempest_test_blacklist
Specifies a blacklist file to skip tests that are not needed.
Pass a full path to the file.
.. zuul:rolevar:: tox_envlist
:default: smoke
The Tempest tox environment to run.
.. zuul:rolevar:: tempest_black_regex
:default: ''
A regular expression used to skip the tests.
It works only when used with some specific tox environments
('all', 'all-plugin'.)
Multi-line and commented regexs can be achieved by doing this:
::
vars:
tempest_black_regex: |
(?x) # Ignore comments and whitespaces
# Line with only a comment.
(tempest.api.identity).*$
.. zuul:rolevar:: tox_extra_args
:default: ''
String of extra command line options to pass to tox.
Here is an example of running tox with --sitepackages option:
::
vars:
tox_extra_args: --sitepackages