]>
Commit | Line | Data |
---|---|---|
7c673cae FG |
1 | ceph-qa-suite |
2 | ------------- | |
3 | ||
4 | clusters/ - some predefined cluster layouts | |
5 | suites/ - set suite | |
6 | ||
7 | The suites directory has a hierarchical collection of tests. This can be | |
8 | freeform, but generally follows the convention of | |
9 | ||
10 | suites/<test suite name>/<test group>/... | |
11 | ||
12 | A test is described by a yaml fragment. | |
13 | ||
14 | A test can exist as a single .yaml file in the directory tree. For example: | |
15 | ||
16 | suites/foo/one.yaml | |
17 | suites/foo/two.yaml | |
18 | ||
19 | is a simple group of two tests. | |
20 | ||
21 | A directory with a magic '+' file represents a test that combines all | |
22 | other items in the directory into a single yaml fragment. For example: | |
23 | ||
24 | suites/foo/bar/+ | |
25 | suites/foo/bar/a.yaml | |
26 | suites/foo/bar/b.yaml | |
27 | suites/foo/bar/c.yaml | |
28 | ||
29 | is a single test consisting of a + b + c. | |
30 | ||
31 | A directory with a magic '%' file represents a test matrix formed from | |
32 | all other items in the directory. For example, | |
33 | ||
34 | suites/baz/% | |
35 | suites/baz/a.yaml | |
36 | suites/baz/b/b1.yaml | |
37 | suites/baz/b/b2.yaml | |
38 | suites/baz/c.yaml | |
39 | suites/baz/d/d1.yaml | |
40 | suites/baz/d/d2.yaml | |
41 | ||
42 | is a 4-dimensional test matrix. Two dimensions (a, c) are trivial (1 | |
43 | item), so this is really 2x2 = 4 tests, which are | |
44 | ||
45 | a + b1 + c + d1 | |
46 | a + b1 + c + d2 | |
47 | a + b2 + c + d1 | |
48 | a + b2 + c + d2 | |
49 | ||
50 | Symlinks are okay. | |
51 | ||
52 | The teuthology code can be found in https://github.com/ceph/teuthology.git |