openinfra/refstack-client
Code Issues Proposed changes
Testing and result upload client for refstack
25 Commits 1 Branch 1 Tag 2.9 MiB
Python 91.7%
Shell 7.9%
Dockerfile 0.4%
9403991171
Go to file
sslypushenko 9403991171 Updating tests results format according to spec 
Spec:
https://github.com/stackforge/refstack/blob/master/specs/approved/api-v1.md

Update patch:
https://review.openstack.org/#/c/146680/

Change-Id: I75c62090a45d742b88acdfe080e24d62658976ce
2015-01-15 19:51:10 +02:00
doc Initial documentation dump 2014-09-11 18:17:20 -04:00
refstack_client Updating tests results format according to spec 2015-01-15 19:51:10 +02:00
.gitignore Added the actual post request to upload 2015-01-12 22:53:23 -08:00
.gitreview Update the README file. 2014-07-30 18:20:53 -07:00
.testr.conf Replace setup_ubuntu_env.sh to universal script 2014-10-13 20:59:04 +00:00
LICENSE First Commit 2014-07-10 11:48:59 -07:00
README.rst Setup_env script should install Tempest from tag 2014-12-12 14:10:13 +02:00
refstack-client Add ability to upload test results 2014-10-26 18:03:43 -07:00
requirements.txt Setup_env script should install Tempest from tag 2014-12-12 14:10:13 +02:00
setup_env Setup_env script should install Tempest from tag 2014-12-12 14:10:13 +02:00
setup.cfg Rename refstack-client to refstack_client 2014-09-23 15:17:17 +03:00
setup.py First Commit 2014-07-10 11:48:59 -07:00
test-requirements.txt Updating tests results format according to spec 2015-01-15 19:51:10 +02:00
tox.ini Change returncode checking to file checking 2015-01-07 10:54:55 -08:00

README.rst

refstack-client

refstack-client is a command line utility that allows you to execute Tempest test runs based on configurations you specify. When finished running Tempest it sends the passed test data back to the Refstack API server.

Environment setup

We've created an "easy button" for Ubuntu, Centos, RHEL and openSuSe.

$ ./setup_env

Options:

a. -t option allows to specify tag in Tempest repository which will be installed. By default, Tempest from last tag release will be used.

Usage

  1. Prepare a tempest configuration file that is customized to your cloud environment.

  2. Change the directory to the refstack-client directory (i.e. cd ~/refstack-client).

  3. Source to use the correct Python environment.

    source .venv/bin/activate

  4. Test your cloud by typing:

    ./refstack-client test -c <Path of the tempest configuration file to use>

    Note:

    1. Adding -v option will show the summary output.
    2. Adding -vv option will show the Tempest test result output.
    3. Adding -t option will only test a particular test case or a test group. This option can be used for quick verification of the target test cases (i.e. -t "tempest.api.identity.admin.test_roles").
    4. Adding --url option will upload the test results to the specified Refstack API server instead of the default Refstack API server. server instead of the default Refstack API server.
    5. Adding --offline option will have your test results not be uploaded.

    Upload:

    If you previously ran a test with refstack-client using the --offline option, you can upload your results to a Refstack API server by using the following command:

    ./refstack-client upload <Path of results file>

    The results file is a JSON file generated by refstack-client when a test has completed. This is saved in .venv/src/tempest/.testrepository. When you use the 'upload' command, you can also override the Refstack API server uploaded to with the --url option.