samos123/tempest repository overview

⁠Tempest Docker Image

Latest tempest master and releases available via Docker Hub or as .tar.xz to run tempest easily in both offline and online environments. Download the tempest.tar.xz and take it with you on an USB stick for those environments without Docker Hub Registry access. The portable image file is created with docker export and compressed with xz.

The following versions/tags are available:

Available on Docker Hub registry: samos123/tempest⁠
Source Code on Github: samos123/docker-tempest⁠

⁠Running tempest

Create a tempest home directory which will be mounted by the container:

mkdir tempest-home

Run the tempest container by mounting the created tempest home directory and executing bash inside the container:

docker run -v tempest-home:/tempest-home -it samos123/tempest bash

Inside the tempst home initialize a new tempest configuration

tempest init

You will now have etc/tempest.conf and etc/tempest.conf.sample inside your tempest home. You should configure etc/tempest.conf to match your needs. After you've done so can run tempest tests with:

ostestr --regex '(?!.*\[.*\bslow\b.*\])(^tempest\.(api|scenario))'

For configuration please visit: Tempest Configuration Documentation⁠.

Extra bonus command: Run tempest and generate HTML reports

ostestr --regex '(?!.*\[.*\bslow\b.*\])(^tempest\.(api|scenario))' --subunit --no-pretty >> tempest-results.log
subunit2html tempest-results.log tempest-results.html

⁠Importing from Raw Image

Note: This is only required if you're using the Raw Image. The following steps can be used to import the downloaded Raw Image .tar.xz image file:

xz -d tempest.tar.xz
docker load -i tempest.tar
imgid=$(docker images | grep "<none>" | awk '{ print $3 }')
docker tag $imgid samos123/tempest