Use python-tempestconf as Python module

python-tempestconf can be imported and used from a different Python project.

Warning

The import of config_tempest is possible only when the version of the tool is at least 2.0.0.

Installation

See our Install Guide on how to install python-tempestconf.

Import

Import python-tempestconf in your project as follows:

from config_tempest import main as tempestconf

python-tempestconf needs cloud credentials in order to create a tempest configuration file. There is a helper method for obtaining cloud credentials which uses openstacksdk for parsing the cloud for credentials.

The following example shows how to get cloud credentials and how to pass it to the configuration tool:

# The following call will return a dict containing cloud credentials,
# for example:
# >>> tempestconf.get_cloud_creds(args_namespace)
# {
#     'username': 'demo',
#     'project_name': 'demo',
#     'user_domain_name': 'Default',
#     'auth_url': 'http://172.16.52.8:5000/v3',
#     'password': 'f0921edc3c2b4fc8',
#     'project_domain_name': 'Default'
# }
cloud_creds = tempestconf.get_cloud_creds(args_namespace)

# Then the configuration step can be run using:
tempestconf.config_tempest(cloud_creds=cloud_creds)

Note

If args_namespace contains --os-cloud argument, the get_cloud_creds method returns cloud credentials related to that cloud, otherwise, it returns credentials of the current cloud (according to the sourced credentials).

List of arguments which may be passed to config_tempest

  • cloud_creds

  • create

  • create_accounts_file

  • debug

  • deployer_input

  • image_disk_format

  • image_path

  • network_id

  • non_admin

  • os_cloud

  • out

  • overrides

  • remove

  • test_accounts

  • verbose

OR

Note

For detailed description of the options see our CLI documentation

Example implementation

  1. Save following code snippet as example.py:

    import argparse
from config_tempest import main as tempestconf

parser = argparse.ArgumentParser(description='Example implementation.')
args = parser.parse_args()

# get the credentials of the current cloud according to
# the sourced credentials
cloud_creds = tempestconf.get_cloud_creds(args)

tempestconf.config_tempest(non_admin=True,
                           out='./etc/tempest.conf',
                           cloud_creds=cloud_creds)

  2. Source your OpenStack RC file containing the cloud credentials. Let’s say you have a overcloud_rc file with the following content:

    $ cat overcloud_rc
unset OS_SERVICE_TOKEN
export OS_USERNAME=demo
export OS_PASSWORD='password'
export OS_AUTH_URL=http://172.16.52.15/identity/v3
export PS1='[\u@\h \W(keystone_demo)]\$ '
export OS_PROJECT_NAME=demo
export OS_USER_DOMAIN_NAME=default
export OS_PROJECT_DOMAIN_NAME=default
export OS_IDENTITY_API_VERSION=3

    Then it can be source by:

    $ source overcloud_rc

  3. Run example.py:

    $ python example.py

Example implementation with a named cloud

  1. Let’s say there is a clouds.yaml file located in /etc/openstack/ with the following content:

    $ cat /etc/openstack/clouds.yaml
clouds:
  devstack:
    auth:
      auth_url: http://172.16.52.15/identity/v3
      password: password
      project_domain_id: default
      project_name: demo
      user_domain_id: default
      username: demo
    identity_api_version: '3'
    region_name: RegionOne
    volume_api_version: '2'

  2. Save following code snippet as example.py:

    import argparse
from config_tempest import main as tempestconf

parser = argparse.ArgumentParser(description='Example implementation.')
# Let's add an os_cloud option which will be passed
# to config_tempest later.
parser.add_argument('--os-cloud', help='Name of a named cloud.')
args = parser.parse_args()

# get the credentials to the devstack cloud
cloud_creds = tempestconf.get_cloud_creds(args)

tempestconf.config_tempest(non_admin=True,
                           out='./etc/tempest.conf',
                           cloud_creds=cloud_creds)

  3. Run example.py:

    $ python example.py --os-cloud devstack

    Note

    In this example you don’t need to source cloud credentials. The credentials are obtained from the /etc/openstack/clouds.yaml file thanks to --os-cloud argument.