blob: 91b0b5fcb9111c8b1b2e58c32e91d5c92a0bb194 [file] [log] [blame]
Andrea Frittoli (andreaf)7d5445d2017-10-03 18:43:05 +01001Run Tempest
2
3**Role Variables**
4
5.. zuul:rolevar:: devstack_base_dir
6 :default: /opt/stack
7
8 The devstack base directory.
9
10.. zuul:rolevar:: tempest_concurrency
11 :default: 0
12
13 The number of parallel test processes.
14
Luigi Toscanoe8a1f532017-11-16 15:22:07 +010015.. zuul:rolevar:: tempest_test_regex
16 :default: ''
17
18 A regular expression used to select the tests.
Michel Peterson515edd42017-12-21 17:22:49 +020019
Luigi Toscanoe8a1f532017-11-16 15:22:07 +010020 It works only when used with some specific tox environments
21 ('all', 'all-plugin'.)
22
Martin Kopec4af65402020-02-05 14:57:10 +000023 In the following example only api scenario and third party tests
24 will be executed.
Michel Peterson515edd42017-12-21 17:22:49 +020025
26 ::
27 vars:
Martin Kopec4af65402020-02-05 14:57:10 +000028 tempest_test_regex: (tempest\.(api|scenario|thirdparty)).*$
Michel Peterson515edd42017-12-21 17:22:49 +020029
Michel Petersonef1a16d2018-02-23 20:20:22 +020030.. zuul:rolevar:: tempest_test_blacklist
31
32 Specifies a blacklist file to skip tests that are not needed.
33
34 Pass a full path to the file.
35
Andreas Jaegerba2f4792018-01-12 16:48:52 +010036.. zuul:rolevar:: tox_envlist
Andrea Frittoli (andreaf)7d5445d2017-10-03 18:43:05 +010037 :default: smoke
38
39 The Tempest tox environment to run.
Chandan Kumara9445042018-02-26 10:22:29 +000040
41.. zuul:rolevar:: tempest_black_regex
42 :default: ''
43
44 A regular expression used to skip the tests.
45
46 It works only when used with some specific tox environments
47 ('all', 'all-plugin'.)
48
Chandan Kumara9445042018-02-26 10:22:29 +000049 ::
50 vars:
Martin Kopec4af65402020-02-05 14:57:10 +000051 tempest_black_regex: (tempest.api.identity).*$
Sergey Vilgelm2979bff2018-11-06 10:34:03 -060052
53.. zuul:rolevar:: tox_extra_args
54 :default: ''
55
56 String of extra command line options to pass to tox.
57
58 Here is an example of running tox with --sitepackages option:
59
60 ::
61 vars:
62 tox_extra_args: --sitepackages
Dmitry Tantsur5952f852019-08-29 14:06:12 +020063
64.. zuul:rolevar:: tempest_test_timeout
65 :default: ''
66
67 The timeout (in seconds) for each test.
Ghanshyam56149022020-02-05 15:53:26 -060068
69.. zuul:rolevar:: stable_constraints_file
70 :default: ''
71
72 Upper constraints file to be used for stable branch till stable/rocky.
73
74.. zuul:rolevar:: tempest_tox_environment
75 :default: ''
76
77 Environment variable to set for run-tempst task.
78
79 Env variables set in this variable will be combined with some more
80 defaults env variable set at runtime.