Tempest does not serve all kind of fancy service cataog format.
Service catalog should be in some standard and consistant format.
This patch adds those in doc to clarify the expected format of catalogs.
Change-Id: I5fb94510c019cca2e81112fb8cf123a3dfab8daf
Since we have a official cookiecutter project we should
rely on it in the documentation. All titles are moved a bit
since only the usage of the cookiecutter and the entry point
is needed to create a working test project. All other information
is just additional and not mandatory for plugin creation.
Change-Id: Ia04d2ea747f19d7b1d272bd7664ff05f61c7c88c
Renaming the isolated_creds module to dynamic_creds module, and rename
the IsolatedCreds class to DynamicCredentialProvider in preparation
to migration to tempest-lib.
Partially implements bp tempest-library
Change-Id: I78a4884e980ef7d0103639cb3792a54c69fb7761
Init command was not working properly as it could not locate the
configuration sample file.
Steps taken:
- Move config-generator.tempest.conf to etc so it will be installed
with pbr.
- Update all files with new path to config-generator-tempest.conf as
needed.
- Refactor init command so if it detects we are not in a virtual
environment, try to find the global config directory /etc/tempest.
If that fails fallback to [sys.prefix]/etc/tempest.
Closes-Bug: #1491058
Closes-Bug: #1490670
Change-Id: I960bc711ff78ac2b0441ef63dff8ec4fb268fd3a
This commit deprecates the original configuration options for
providing credentials. This mechanism of providing tempest with
credentials to run with has a lot of drawbacks and has been
superseded by using an accounts.yaml file. It has been planned
for deprecation once we had a periodic/experimental CI job setup
to run with test accounts enabled. Now that this has been done
we can start the deprecation cycle for the old options.
Change-Id: Ia5132c5cb32355d6f26b8acdd92a0e55a2c19f41
This commit fixes a few things in the tempest docs. First it fixes all
of the sphinx warnings and enables fail on warn to ensure we're using
valid sphinx everywhere. It also adds a link from the configuration
guide to the sample config file.
Change-Id: I3ad645a6bbfa46b4498e1732410743e46d6eb0cb
This commit switches to using the oslo.config sphinx extension to
generate a sample config instead of doing it manually in the docs'
conf.py module.
Change-Id: I7032cb4f56c728911ffa5c6911eb504f53bc80af
This commit adds a subsubsection to the plugin interface docs to
elaborate a bit on how to deal with configuration options. Previously,
how to use them in a plugin was implied, but nothing was explicitly
stated. This corrects that to make it clear on how to deal with
configuration.
Change-Id: Id3afc9657c5419cfba61acb3c84ccfea104d1b20
The indefinite article of the word "alternate" had became "a".
Fix it to "an".
Closes-Bug #1486786
Change-Id: I8d66d066f218fdb3cb70e45ebbcc6be6ae2e5925
The expectation from users is that to build docs locally all you need
to do is run build_sphinx on the repo and the docs will be fully
created. When we added the sample config to the tempest docs we ignored
this and just added the sample config generation to the docs tox job.
This commit fixes this by baking in the sample config generation to
the sphinx conf.py file which should ensure we have the sample config
generated every time that we call build_sphinx.
Change-Id: Ifd570707847f52592f5bc9bc743b8d3c98512639
This commit starts the docs section on creating and using tempest
plugins. It describes how to create a plugin class, an entrypoint, and
a recommended dir structure. As well notes how to use tempest and
tempest-lib in creating a plugin. It'll likely be expanded in the
future as the plugin interface evolves.
Partially Implements bp external-plugin-interface
Change-Id: If2e0c47d0a719d869a3301ddbca07495c81cc498
Since including the sample configuration in tree is
becoming difficult to maintain, lets try moving it to
the developer docs. We still have the ability to view it
easily for users, and it can be auto-generated on doc build,
so it should also always be up to date.
Change-Id: I7ec2d76448feef5ecb9af7c238bbd12619fa31d8
Added docstring to cmd/account_generator.py.
Fixed help messages.
Added sphinx documentation for tempest-account-generator utility.
Change-Id: I6640ba8a0eaaea187cf38582ab537394dec020b6
This commit adds a new config option to the auth section,
create_isolated_networks, to disable tenant isolation from attempting
to create an isolated network stack on each created tenant. This is
needed because in certain neutron configurations the extra resource
creations are not need or not allowed.
Change-Id: I0899a43709a0cb2967376e914248d2ad4a37773a
Closes-Bug: #1447829
When using the lock testing accounts, allow_tenant_isolation
should be set as False. Now it's missing in the document.
This patch will add it.
Closes-Bug: #1454001
Change-Id: I3e1e7a31ea4c1c8b25e821df545c8674a8de38da
The cli tests have been marked for removal for ~6 months and the
framework was the first thing included in tempest lib. There has
been more than enough time for all the projects to pick this up
in the client repos. So let's remove it all!
As part of this a couple of missing entries for tempest's
requirements.txt were found. These dependencies were being installed
by the clients so the fact they were missing was never noticed prior
to this. This commit also adds these missing entries back into the
requirements file.
Change-Id: I4f8638f1c048bbdb598dd181f4af272ef9923806
This commit cleans up some details in the accounts.yaml sample file
and the tempest configuration guide to provide missing details about
how to create and use an accounts file. Specifically it adds more
detailed comments to the sample file about each section, and in the
config guide it removes obsolete sections and adds some missing
details.
Change-Id: Ic11335fe1215ab0625ea2308ccc75d22a284c432
Closes-Bug: #1447851
This commit fixes several issues with the non-locking cred provider
section in the tempest config guide. It was in a state stuck between
refactors and didn't accurately describe how it should be used anymore.
Change-Id: Ibc6ca1816f6673e2c8dbd6ae3451e03914f04137
This commit adds a paragraph to the tempest configuration guide on how
to use the tempest_roles option. This was previously missing from the
tenant isolation section.
Change-Id: I1ef1649186edbeb51e1ced1bbb361b78eaef3721
This commit adds a section to the config guide on how to configure
the available services and the corresponding entries in the service
catalog for those services.
Change-Id: I70d7feb47b2df4b6caf9d38d8e79b59bb30fb894
This commit adds another section to the tempest config guide outlining
how the service feature enabled sections should be configured.
Change-Id: Iaedf744068b3f91f72144efcaab5d9eaeb9adb0c
This commit adds additional sections to the tempest configuration guide
to elaborate on the details of several required options when configuring
tempest. Specifically this covers how to set the keystone connection
info, flavors to use for testing, and image setup.
Change-Id: I5a72443a3b05e39eba2eac1c4c9a4d6eef26797d
This commit adds a networking section to the tempest configuration
guide to start explaining the various facets of networking
configuration. Right now it only contains a guide around how to
configure tempest to provide a network on server creation. Additional
subsections will be added later on.
Change-Id: Ibdfd8becce18de0ef414027d5e7c580f852607a7
This commit removes support for using an accounts.yaml file with the
non-locking provider. There is no reason the non-locking provider
would ever need to be used with an accounts.yaml file because the
locking provider supports running serially just fine. (which would be
the sole use case for accounts file with the non-locking provider)
Doing this relegates the non-locking provider to just handle the
legacy config options for providing credentials.
Removing this code path provides the advantage of removing a double
maintenance burden for the non-locking provider, in addition to
simplifying the config and user story around the cred providers. It
also turns out this config permutation was never properly tested and
didn't actually work.
Change-Id: I8088d75897589203264ae29326fe9901c3457cc3
This commit makes several needed cleanups and improvements to the
tempest readme to make things clearer and elaborate on some sections.
Also as the readme is intended to be a tempest users guide, this moves
sections which are more developer focused to the hacking guide.
Change-Id: I4180ce18268443873fe7d8d5e7d0aaebc2cd1e08
This commit adds a section to the tempest configuration guide on
configuring the lock_path for running tempest and explains why it
is needed.
Change-Id: I73913797d96f9f833e02e5b37be9c0c85b3ae959
This commit updates the auth/credentials section of the tempest
configuration guide to reflect recent changes made to the credential
providers and config file.
Change-Id: I4633ff14be1c33f780b671f0ac0c98884ecc94bc
This commit adds a new doc page to the tempest documentation to
provide a guide to configuring tempest. It currently contains one
section to elaborate on the credentials and auth options in the config
file. This doc will be expanded in the future to add details around
other pieces of tempest configuration.
Change-Id: Iaf7cefc6a5e508437e4b4620ba5bfaa221f3611b
I followed what's done for the cleanup.py script and re-used parts of
what was described in the javelin spec.
Change-Id: I57adc3764e75784d4614b6c03996433a4ee4332f
Remove intersphinx from the docs build as it triggers network calls that
occasionally fail, and we don't really use intersphinx (links other
sphinx documents out on the internet)
This also removes the requirement for internet access during docs build.
This can cause docs jobs to fail if the project errors out on
warnings.
Change-Id: Icdb04bbe9eb931b07e7363ebb852fa9e73b088ea
Related-Bug: #1368910