Chapter 5. Using Tempest
Chapter 5. Using Tempest Run the commands in this section to perform various test operations. You can also combine multiple options in a single tempest run command. 5.1. Listing Available Tests Run the tempest-run command with either the --list-tests or -l options to get a list of available tempest tests: 5.2. Running Smoke Tests 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. 5.3. Passing Tests Using Whitelist Files 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: 5.4. Skipping Tests Using Blacklist Files 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: 5.5. Running Tests in Parallel Concurrently, or Serially Run the tests serially: Run the tests in parallel. Parallel testing is the default: Use the --concurrency or -c option to specify the number of workers to use when running tests in parallel: By default, the Integration Test Suite uses one worker for each CPU available. 5.6. Running Specific Tests Run specific tests with the --regex regular expression option. The regular expression must be Python regular expression: For example, use the following example command to run all tests that have names beginning with tempest.scenario :
tempest run -l tempest run --smoke tempest run -w <whitelist_file> tempest run -b <blacklist_file> tempest run --serial tempest run --parallel tempest run --concurrency <workers> tempest run --regex <regex> tempest run --regex ^tempest.scenario