summaryrefslogtreecommitdiff
path: root/README.rst
blob: 43b08cfce370d58207aaa30353c2840566d4da4a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
==========
 oslotest
==========

OpenStack test framework and test fixtures

* Free software: Apache license
* Documentation: http://docs.openstack.org/developer/oslotest

Cross-testing With Other Projects
=================================

The oslotest package is cross-tested against its consuming projects to
ensure that no changes to the library break the tests in those other
projects.

In the Gate
-----------

To add your project to the list for cross-testing, update
``modules/openstack_project/files/jenkins_job_builder/config/projects.yaml``
in the openstack-infra/config git repository and add sections like:

::

   - '{pipeline}-oslo.test-dsvm-{name}{branch-designator}':
       pipeline: check
       node: 'devstack-precise || devstack-precise-check'
       branch-designator: ''
       branch-override: default
   - '{pipeline}-oslo.test-dsvm-{name}{branch-designator}':
       pipeline: gate
       node: devstack-precise
       branch-designator: ''
       branch-override: default

to the ``jobs`` list for your project. Refer to
https://review.openstack.org/#/c/76381 for an example.

Then update ``modules/openstack_project/files/zuul/layout.yaml`` by
adding the new check test to the global list of jobs (to make it
non-voting to start), and then to your project and to oslo.test.

::

  - name: check-oslo.test-dsvm-oslo.messaging
    voting: false

::

    - name: openstack/oslo.messaging
      ...
      check:
      ...
        - check-oslo.test-dsvm-oslo.messaging
      ...

::

    - name: openstack/oslo.test
      ...
      check:
      ...
        - check-oslo.test-dsvm-oslo.messaging
      ...


Locally
-------

To run the cross-tests locally, invoke the script directly, passing
the path to the other source repository and the tox environment name
to use:

::

  $ cd oslo.test
  $ ./tools/run_cross_tests.sh ~/repos/openstack/oslo.config py27