Files
openstack-ansible-os_tempest/doc/source/user/configuration.rst
lpiwowar 16d3b3fd18 Update URL for documentation of python-tempestconf
The URL for documentation of python-tempestconf has changed with this
patch [1].

This patch updates the URL for documentation of python-tempestconf
to make it consistent across all repositories.

[1] https://review.opendev.org/c/openinfra/python-tempestconf/+/815473

Change-Id: Ifa140d2b43ffe9c85e875fa4891d4a3757570934
2021-11-23 10:22:27 +01:00

2.4 KiB

os_tempest configuration

This page shows all of the variables which can be set in order to control the behaviour of os_tempest role and provides examples on how to do so.

For a list of all variables with a default value set, please, refer to the this page.

Set the name of the cloud

os-tempest uses named cloud credentials so it requires the name of the cloud the role will be executed against. The name is provided to os-tempest via the tempest_cloud_name variable. In order to use named clouds a clouds.yaml file needs to be present on the target host. clouds.yaml file needs to be stored at one of the supported locations, see here For more information about named clouds, please, follow to the os-client-config official documentation

Warning

clouds.yaml file has to be present on the target host - the host os_tempest is gonna be executed against.

python-tempestconf

python-tempestconf is a tool which generates a tempest.conf file necessary for Tempest execution. For more information about the tool, please, follow its official documentation.

If you want os_tempest to execute python-tempestconf, prior to Tempest execution in order to generate tempest.conf file, set tempest_use_tempestconf variable to true:

tempest_use_tempestconf: true

More information about python-tempestconf arguments can be found here.

The best way how to pass any arguments to python-tempestconf is using its profile feature.

os_tempest provides tempest_tempestconf_profile variable for setting desired python-tempestconf's arguments. For example, if you wanted to define debug to true, os-cloud to demo and override output of python-tempestconf to /my/location/tempest.conf, it would be done by:

tempest_tempestconf_profile:
  debug: true
  os-cloud: demo
  out: /my/location/tempest.conf