Chapter 23. Integration Test Suite command-line client

--version

show program's version number and exit

-v, --verbose

Increase verbosity of output. Can be repeated.

-q, --quiet

Suppress output except warnings and errors.

--log-file LOG_FILE

Specify a file to log output. Disabled by default.

-h, --help

Show help message and exit.

--debug

Show tracebacks on errors.

Positional arguments

accounts_file.yaml

Output accounts yaml file

Optional arguments

-h, --help

show this help message and exit

-c /etc/tempest.conf, --config-file /etc/tempest.conf

path to tempest config file

--os-username <auth-user-name>

User should have permissions to create new user accounts and tenants. Defaults to env[OS_USERNAME].

--os-password <auth-password>

Defaults to env[OS_PASSWORD].

--os-tenant-name <auth-tenant-name>

Defaults to env[OS_TENANT_NAME].

--tag TAG

Resources tag

-r CONCURRENCY, --concurrency CONCURRENCY

Concurrency count

--with-admin

Creates admin for each concurrent group

Optional arguments

-h, --help

show this help message and exit

--init-saved-state

Creates JSON file: saved_state.json, representing the current state of your deployment, specifically object types tempest creates and destroys during a run. You must run with this flag prior to executing cleanup in normal mode, which is with no arguments.

--delete-tempest-conf-objects

Force deletion of the tempest and alternate tempest users and tenants.

--dry-run

Generate JSON file:dry_run.json, that reports the objects that would have been deleted had a full cleanup been run.

Positional arguments

dir

Optional arguments

-h, --help

show this help message and exit

--config-dir CONFIG_DIR, -c CONFIG_DIR

Optional arguments

-h, --help

show this help message and exit

Optional arguments

-h, --help

show this help message and exit

-d DURATION, --duration DURATION

Duration of test in secs

-s, --serial

Trigger running tests serially

-S, --stop

Stop on first error

-n NUMBER, --number NUMBER

How often an action is executed for each process

-a, --all

Execute all stress tests

-T TYPE, --type TYPE

Filters tests of a certain type (e.g. gate)

-i, --call-inherited

Call also inherited function with stress attribute

-t [TESTS], --tests [TESTS]

Name of the file with test description

Optional arguments

-h, --help

show this help message and exit

-u, --update

Update the config file with results from api queries. This assumes whatever is set in the config file is incorrect. In the case of endpoint checks where it could either be the incorrect catalog type or the service available option the service available option is assumed to be incorrect and is thus changed

-o OUTPUT, --output OUTPUT

Output file to write an updated config file to. This has to be a separate file from the original config file. If one isn't specified with -u the new config file will be printed to STDOUT

-r, --replace-ext

If specified the all option will be replaced with a full list of extensions