34fe2eca58
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
102 lines
2.6 KiB
ReStructuredText
102 lines
2.6 KiB
ReStructuredText
.. _functional-tests:
|
|
|
|
===================
|
|
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
|