| Ghanshyam Mann | 1e4cb1d | 2021-04-21 18:25:18 -0500 | [diff] [blame] | 1 | Run Tempest |
| 2 | |
| 3 | The result of the tempest run is stored in the `tempest_run_result` |
| 4 | variable (through the `register` statement). |
| 5 | |
| 6 | **Role Variables** |
| 7 | |
| 8 | .. zuul:rolevar:: devstack_base_dir |
| 9 | :default: /opt/stack |
| 10 | |
| 11 | The devstack base directory. |
| 12 | |
| 13 | .. zuul:rolevar:: tempest_concurrency |
| 14 | :default: 0 |
| 15 | |
| 16 | The number of parallel test processes. |
| 17 | |
| 18 | .. zuul:rolevar:: tempest_test_regex |
| 19 | :default: '' |
| 20 | |
| 21 | A regular expression used to select the tests. |
| 22 | |
| 23 | It works only when used with some specific tox environments |
| Lukáš Piwowarski | be19f21 | 2022-10-07 13:47:11 +0200 | [diff] [blame] | 24 | ('all', 'all-site-packages') |
| Ghanshyam Mann | 1e4cb1d | 2021-04-21 18:25:18 -0500 | [diff] [blame] | 25 | |
| 26 | In the following example only api scenario and third party tests |
| 27 | will be executed. |
| 28 | |
| 29 | :: |
| 30 | vars: |
| 31 | tempest_test_regex: (tempest\.(api|scenario|thirdparty)).*$ |
| 32 | |
| 33 | .. zuul:rolevar:: tempest_test_blacklist |
| 34 | |
| 35 | Specifies a blacklist file to skip tests that are not needed. |
| 36 | |
| 37 | Pass a full path to the file. |
| 38 | |
| 39 | .. zuul:rolevar:: tox_envlist |
| 40 | :default: smoke |
| 41 | |
| 42 | The Tempest tox environment to run. |
| 43 | |
| 44 | .. zuul:rolevar:: tempest_black_regex |
| 45 | :default: '' |
| 46 | |
| 47 | A regular expression used to skip the tests. |
| 48 | |
| 49 | It works only when used with some specific tox environments |
| Lukáš Piwowarski | be19f21 | 2022-10-07 13:47:11 +0200 | [diff] [blame] | 50 | ('all', 'all-site-packages'). |
| Ghanshyam Mann | 1e4cb1d | 2021-04-21 18:25:18 -0500 | [diff] [blame] | 51 | |
| 52 | :: |
| 53 | vars: |
| 54 | tempest_black_regex: (tempest.api.identity).*$ |
| 55 | |
| 56 | .. zuul:rolevar:: tox_extra_args |
| 57 | :default: '' |
| 58 | |
| 59 | String of extra command line options to pass to tox. |
| 60 | |
| 61 | Here is an example of running tox with --sitepackages option: |
| 62 | |
| 63 | :: |
| 64 | vars: |
| 65 | tox_extra_args: --sitepackages |
| 66 | |
| 67 | .. zuul:rolevar:: tempest_test_timeout |
| 68 | :default: '' |
| 69 | |
| 70 | The timeout (in seconds) for each test. |
| 71 | |
| 72 | .. zuul:rolevar:: stable_constraints_file |
| 73 | :default: '' |
| 74 | |
| 75 | Upper constraints file to be used for stable branch till stable/rocky. |
| 76 | |
| 77 | .. zuul:rolevar:: tempest_tox_environment |
| 78 | :default: '' |
| 79 | |
| 80 | Environment variable to set for run-tempst task. |
| 81 | |
| 82 | Env variables set in this variable will be combined with some more |
| 83 | defaults env variable set at runtime. |