Tempest is a set of integration tests to be run against a live OpenStack cluster. Tempest has batteries of tests for OpenStack API validation, Scenarios, and other specific tests useful in validating an OpenStack deployment.
Alongside with the tempest project, this snap also includes the currently maintained tempest plugins, the python-tempestconf package and several curated test lists to provide ease of use.
The python-tempestconf package provides discover-tempest-config command line
application that automatically generates a tempest configuration appropriate for your cloud.
Plugins
The snap provides all the plugins listed in the OpenStack release notes and those cannot be removed or updated. Currently, it is not possible to add new plugins or use your own.
List of plugins:
Quickstart
Running the tempest smoke suite against a deployed OpenStack cloud would look like this.
# Install the tempest snap
sudo snap install tempest
# Have the cloud credentials in the environment
source novarc
# Initialize a tempest workspace directory called cloud-01
tempest init cloud-01
cd cloud-01
# Generate the tempest configuration specific to the cloud
# use `--create` flag if resources like flavors needs to be created
discover-tempest-config
# Run the tempest smoke suite
tempest run --smoke
For more information please refer to the Tempest QuickStart and python-tempestconf documentation.
Test Lists
The tempest snap provides a set of pre-defined test lists with different profiles and a mechanism to specify them easily.
The @BUILTIN_TESTLISTS keyword will be automatically replaced by the full path
of the directory storing the built-in test lists.
Note: the single-quotation marks around the test list file path is required
if the @BUILTIN_TESTLISTS keyword is used (in other words, when running tempest
with a built-in test list file). Failure to do so will result in a wrong path
error.
readonly-quick
For quickly verifying the behavior of the target cloud and making sure tempest
is correctly set up
tempest run --load-list '@BUILTIN_TESTLISTS/readonly-quick'
refstack-2022.11
Version 2022.11 of the RefStack guidelines.
The list includes the required and advisory tests of all platforms.
tempest run --load-list '@BUILTIN_TESTLISTS/refstack-2022.11'
Links
OpenStack Release Notes
https://releases.openstack.org/antelope/index.html#tempest-plugins
python-tempestconf
https://opendev.org/openinfra/python-tempestconf
discover-tempest-config
https://docs.opendev.org/openinfra/python-tempestconf/latest/cli/cli_options.html#discover-tempest-config
Tempest QuickStart
https://docs.openstack.org/tempest/latest/overview.html#quickstart
RefStack
https://refstack.openstack.org/#/
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
You are about to open
Do you wish to proceed?
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
On Arch Linux, snap can be installed from the Arch User Repository (AUR). The manual build process is the Arch-supported install method for AUR packages, and you’ll need the prerequisites installed before you can install any AUR package. You can then install snap with the following:
git clone https://aur.archlinux.org/snapd.git
cd snapd
makepkg -si
Once installed, the systemd unit that manages the main snap communication socket needs to be enabled:
sudo systemctl enable --now snapd.socket
If AppArmor is enabled in your system, enable the service which loads AppArmor profiles for snaps:
sudo systemctl enable --now snapd.apparmor.service
To enable classic snap support, enter the following to create a symbolic link between /var/lib/snapd/snap and /snap:
sudo ln -s /var/lib/snapd/snap /snap
Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly.
To install tempest, simply use the following command:
sudo snap install tempest
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.
