| Stephen Finucane | 95697d8 | 2024-07-23 11:36:49 +0100 | [diff] [blame] | 1 | ======= | 
 | 2 | Tempest | 
 | 3 | ======= | 
 | 4 |  | 
 | 5 | `Tempest`_ is the OpenStack Integration test suite. It is installed by default | 
 | 6 | and is used to provide integration testing for many of the OpenStack services. | 
 | 7 | Just like DevStack itself, it is possible to extend Tempest with plugins. In | 
 | 8 | fact, many Tempest plugin packages also include DevStack plugin to do things | 
 | 9 | like pre-create required static resources. | 
 | 10 |  | 
 | 11 | The `Tempest documentation <Tempest>`_ provides a thorough guide to using | 
 | 12 | Tempest. However, if you simply wish to run the standard set of Tempest tests | 
 | 13 | against an existing deployment, you can do the following: | 
 | 14 |  | 
 | 15 | .. code-block:: shell | 
 | 16 |  | 
 | 17 |     cd /opt/stack/tempest | 
 | 18 |     /opt/stack/data/venv/bin/tempest run ... | 
 | 19 |  | 
 | 20 | The above assumes you have installed DevStack in the default location | 
 | 21 | (configured via the ``DEST`` configuration variable) and have enabled | 
 | 22 | virtualenv-based installation in the standard location (configured via the | 
 | 23 | ``USE_VENV`` and ``VENV_DEST`` configuration variables, respectively). | 
 | 24 |  | 
 | 25 | .. _Tempest: https://docs.openstack.org/tempest/latest/ |