kingbird/kingbird/tests/tempest/scenario/README.rst

Tests for Kingbird in Tempest

How to run

Get the latest kingbird resources from the appropriate mirror:

$ git clone https://github.com/openstack/kingbird.git

Install kingbird, in order to register the tempest plugin interface:

$ cd kingbird
$ python setup.py install

Get the latest tempest resources from the appropriate mirror:

$ git clone https://github.com/openstack/tempest.git

Create a configuration file tempest/etc/tempest.conf for tempest. The sample file can be generated and used for this purpose:

$ cd $TEMPEST_ROOT_DIR
$ tox -e genconfig
$ cp etc/tempest.conf.sample etc/tempest.conf

Some configuration options are required for running tests. Here is the list:

[auth]
admin_username=
admin_project_name=
admin_password=
admin_domain_name=

[identity]
uri=
uri_v3=
auth_version=
username=
password=
region=
tenant_name=
domain_name=
alt_domain_name=
default_domain_id=

[compute]
image_ref=

All the parameters above are defined by tempest.

The parameters which are only specific to kingbird tempest plugin are configured in kingbird/tests/tempest/scenario/config.py by group name KBGroup.

When configuration is finished, you can list the testcases in Kingbird plugin:

$ testr list-tests | grep kingbird

If you want to launch the tests from tempest, you can do with:

$ tox -e all-plugin -- scenario.quota_management.client_tests

If you want to launch all Kingbird tests in Tempest, you can do this with quota_management tag:

$ tox -e all-plugin -- quota_management

If you want to launch a single Kingbird testcase in Tempest, you can do this with:

$ tox -e all-plugin scenario.quota_management.client_tests.test_quota_management_api.KingbirdQMTestJSON.test_kingbird_delete_method