designate/doc/source/functional-tests.rst
Clenimar Filemon 34fe2eca58 Update config samples to show Identity v3 params
As Designate requests its service token using Identity v3, the
config.sample and some docs should reflect this. This patch updates
these files in order to conform to new v3 parameters.

Change-Id: I3205751f0c818f85ffe2fbb2468c6c48fd27eb91
2016-03-29 12:28:02 -03:00

2.6 KiB

Functional tests

The functional tests run against a live Designate, making real requests and verifying they were successful.

Installation

The functional tests are written using tempest-lib. All the dependencies should be in the requirements files:

cd designate
pip install -r requirements.txt -r test-requirements.txt
pip install -e .

Configuration

The Tempest tests require a config file. The config specifies the keystone endpoint to authenticate against, or to run in noauth mode against a Designate without keystone.

Set the TEMPEST_CONFIG environment variable to specify where the config file is:

export TEMPEST_CONFIG=tempest.conf

The config file should look like the following:

[identity]
# optionally override the url from the service catalog
# designate_override_url = http://designate.example.com

# Replace these with values that represent your identity configuration
uri = http://localhost:5000/v2.0
uri_v3 = http://localhost:5000/v3
auth_version = 3
region = RegionOne

username = demo
tenant_name = demo
password = password
domain_name = Default

alt_username = alt_demo
alt_tenant_name = alt_demo
alt_password = password
alt_domain_name = Default

admin_username = admin
admin_tenant_name = admin
admin_password = password
admin_domain_name = Default

[noauth]
# set this to True to run against designate in noauth mode
use_noauth = False
designate_endpoint = http://127.0.0.1:9001
tenant_id = demo
alt_tenant_id = alt_demo
admin_tenant_id = admin

[designate]
# the tests will verify changes propagate out to these nameservers
nameservers = 127.0.0.1:53,127.0.0.2:53

[testconfig]
# Specify how build the path for the request. This will be appended
# directly to the url from the service catalog (or the override url).
#     {tenant_id} - the tenant id
#     {tenant_name} - the tenant name
#     {user} - the username of the tenant
#     {user_id} - the user_id of the tenant
#     {path} - the versionless resource path, e.g. /zones/ID"),
v2_path_pattern = '/v2/{path}'
# if true, skip doing admin actions like increasing quotas in test setups
no_admin_setup = False

Running the tests

Make sure to set the TEMPEST_CONFIG environment variable to point to your test config file.

Then run the tests with tox (you may need to pip install tox):

tox -e functional