| Dmitry Tantsur | ea9af86 | 2018-03-14 16:48:48 +0100 | [diff] [blame] | 1 | Full cloud with the Compute service and flat networking |
| 2 | ======================================================= |
| 3 | |
| 4 | This section documents running tempest on a full OpenStack cloud with the |
| 5 | Compute, Image and Networking services enabled. The Bare Metal Introspection |
| 6 | service (ironic-inspector) is not enabled. Flat networking is used. |
| 7 | |
| 8 | Prerequisite |
| 9 | ------------ |
| 10 | |
| 11 | * `Create a bare metal flavor`_ in the Compute service in advance |
| 12 | and record its ID (``<flavor uuid>`` below). |
| 13 | |
| 14 | * `Create an image`_ to use for instances and record its ID (``<image uuid>``). |
| 15 | It can be either a whole disk or a partition image. |
| 16 | |
| 17 | * Create and record the name or UUID of a flat network to use for bare metal |
| 18 | instances (``<network name>``). |
| 19 | |
| 20 | * Get the minimum and maximum API versions that you want to test against. |
| 21 | Check the `API version history`_ to find the appropriate versions for |
| 22 | your deployment. |
| 23 | |
| 24 | .. note:: The minimum version can usually be set to ``1.1``. |
| 25 | |
| 26 | * Enroll_ at least one node and make it ``available``. |
| 27 | |
| 28 | .. _Create a bare metal flavor: https://docs.openstack.org/ironic/latest/install/configure-nova-flavors.html |
| 29 | .. _Create an image: https://docs.openstack.org/ironic/latest/install/configure-glance-images.html |
| 30 | .. _API version history: https://docs.openstack.org/ironic/latest/contributor/webapi-version-history.html |
| 31 | .. _Enroll: https://docs.openstack.org/ironic/latest/install/enrollment.html |
| 32 | |
| 33 | Configuration |
| 34 | ------------- |
| 35 | |
| 36 | .. code-block:: ini |
| 37 | |
| 38 | [service_available] |
| 39 | # Enable ironic tests. |
| 40 | ironic = True |
| 41 | |
| 42 | # Disable ironic-inspector tests. |
| 43 | ironic-inspector = False |
| 44 | |
| 45 | [baremetal] |
| 46 | # Minimum and maximum API versions to test against. |
| 47 | min_microversion = <min API version as X.Y> |
| 48 | max_microversion = <max API version as X.Y> |
| Dmitry Tantsur | 0c4a693 | 2018-09-07 14:41:57 +0200 | [diff] [blame] | 49 | # Driver to use for API tests for Queens and newer: |
| 50 | driver = fake-hardware |
| Dmitry Tantsur | ea9af86 | 2018-03-14 16:48:48 +0100 | [diff] [blame] | 51 | |
| 52 | [compute] |
| 53 | # Configure the bare metal flavor so that the Compute services provisions |
| 54 | # bare metal instances during the tests. |
| 55 | flavor_ref = <flavor uuid> |
| 56 | flavor_ref_alt = <flavor uuid> |
| 57 | |
| 58 | # Configure the image to use. |
| 59 | image_ref = <image uuid> |
| 60 | image_ref_alt = <image uuid> |
| 61 | |
| 62 | # Configure the network to use. |
| 63 | fixed_network_name = <network name> |
| 64 | |
| 65 | [compute-feature-enabled] |
| 66 | # Ironic does not support this feature. |
| 67 | disk_config = False |
| 68 | |
| 69 | # Not supported with flat networking. |
| 70 | interface_attach = False |
| 71 | |
| 72 | [auth] |
| 73 | # Not supported with flat networking. |
| 74 | create_isolated_networks = False |
| 75 | |
| 76 | [network] |
| 77 | # Required for flat networking. |
| 78 | shared_physical_network = True |