blob: 3e3c56e0f50d5c4ce91a497a78a4ea0e7c420c6f [file] [log] [blame]
Dmitry Tantsura068e662017-12-21 11:14:43 +01001=====
Jim Rollenhagen4f8f2292016-11-18 06:22:18 -05002Usage
Dmitry Tantsura068e662017-12-21 11:14:43 +01003=====
Jim Rollenhagen4f8f2292016-11-18 06:22:18 -05004
Dmitry Tantsura068e662017-12-21 11:14:43 +01005Configuring
6-----------
Jim Rollenhagen4f8f2292016-11-18 06:22:18 -05007
Dmitry Tantsura068e662017-12-21 11:14:43 +01008Update your `Tempest configuration`_ to enable support for ironic:
9
10.. code-block:: ini
11
12 [service_enabled]
13 ironic = True
14
15If introspection tests are needed, also enable support for ironic-inspector:
16
17.. code-block:: ini
18
19 [service_enabled]
20 ironic_inspector = True
21
Dmitry Tantsurea9af862018-03-14 16:48:48 +010022See the following example configurations for more details:
23
24.. toctree::
25 :maxdepth: 1
26
27 config/with-nova
28
29.. TODO(dtantsur): cover standalone tests
Dmitry Tantsura068e662017-12-21 11:14:43 +010030
31.. _Tempest configuration: https://docs.openstack.org/tempest/latest/configuration.html
32
33Running
34-------
35
36Run tests as described in the `Tempest documentation`_. The following patterns
37can be used with ``--regex`` option to only run bare metal tests:
38
39``ironic``
40 all bare metal tests
41``ironic_standalone``
42 standalone bare metal tests that do not use the Compute service
43``InspectorBasicTest``
44 basic introspection tests
45``InspectorDiscoveryTest``
46 introspection auto-discovery tests
47
48.. _Tempest documentation: https://docs.openstack.org/tempest/latest/run.html