Chapter 5. Using Tempest

Run the tempest-run command with either the --list-tests or -l options to get a list of available tempest tests:

tempest run -l

# tempest run -l

Smoke testing is a type of preliminary testing which only covers the most important functionality. While they are not comprehensive, running smoke tests can save time if they do identify a problem.

tempest run --smoke

# tempest run --smoke

A whitelist file is a file that contains regular expressions to select tests that you want to include. Regular expressions are separated by a newline.

Run the tempest run command with either the --whitelist-file or -w options to use a whitelist file:

tempest run -w <whitelist_file>

# tempest run -w <whitelist_file>

A blacklist file is a file that contains regular expressions to select tests that you want to exclude. Regular expressions are separated by a newline.

Run the tempest run command with either the --blacklist-file or -b options to use a blacklist file:

tempest run -b <blacklist_file>

# tempest run -b <blacklist_file>

Run the tests serially:

tempest run --serial

# tempest run --serial

Run the tests in parallel. Parallel testing is the default:

tempest run --parallel

# tempest run --parallel

Use the --concurrency or -c option to specify the number of workers to use when running tests in parallel:

tempest run --concurrency <workers>

# tempest run --concurrency <workers>

By default, the Integration Test Suite uses one worker for each CPU available.

Run specific tests with the --regex regular expression option. The regular expression must be Python regular expression:

tempest run --regex <regex>

# tempest run --regex <regex>

For example, use the following example command to run all tests that have names beginning with tempest.scenario:

tempest run --regex ^tempest.scenario

# tempest run --regex ^tempest.scenario