docs: conventions for test layouts

Signed-off-by: Alfredo Deza <adeza@redhat.com>
pull/1453/head
Alfredo Deza 2017-04-17 15:39:27 -04:00
parent 3c8e41c748
commit f50494d7be
1 changed files with 16 additions and 0 deletions

View File

@ -32,6 +32,22 @@ At the very least, a scenario will need these files:
Conventions
-----------
Python test files (unlike scenarios) rely on paths to *map* where they belong. For
example, a file that should only test monitor nodes would live in
``ceph-ansible/tests/functional/tests/mon/``. Internally, the test runner
(``py.test``) will *mark* these as tests that should run on a monitor only.
Since the configuration of a scenario already defines what node has a given
role, then it is easier for the system to only run tests that belong to
a particular node type.
The current convention is a bit manual, with initial path support for:
* mon
* osd
* mds
* rgw
* journal_collocation
* all/any (if none of the above are matched, then these are run on any host)
.. _testinfra: