Automated Test Case Repository for OpenStack. Based on CloudCAFE.

Go to file

Anna Eilering 7da3790160 Remove try except around setup.py imports and remove distutils workaround. CloudRoast was initially written to support both setuptools and distutils. CloudRoast requires CloudCafe and OpenCafe, neither of which support distutils. If a user is able to install OpenCafe and CloudCafe, they will not require a workaround to install CloudRoast. Additionally the use of Distutils complicates the creation / instantiation of tests for the library. Change-Id: Ib2bbbf57832963695c7966aab64e717dca900ba7		2016-04-15 09:40:41 -05:00
cloudroast	Add register image smoke test	2016-04-07 10:51:33 -05:00
.gitignore	Add DS_Store to gitignore	2014-01-28 08:14:45 -06:00
.gitreview	Update .gitreview for new namespace	2015-10-17 22:02:18 +00:00
AUTHORS.md	Initial Commit	2013-03-30 14:50:01 -05:00
HACKING.rst	Workflow documentation is now in infra-manual	2014-12-05 03:30:43 +00:00
HISTORY.md	Initial Commit	2013-03-30 14:50:01 -05:00
HISTORY.rst	Initial Commit	2013-03-30 14:50:01 -05:00
LICENSE	Initial Commit	2013-03-30 14:50:01 -05:00
MANIFEST.in	Initial Commit	2013-03-30 14:50:01 -05:00
NOTICE	Initial Commit	2013-03-30 14:50:01 -05:00
pip-requires	Initial Commit	2013-03-30 14:50:01 -05:00
README.md	Fix README formatting	2015-05-21 01:32:33 -07:00
setup.py	Remove try except around setup.py imports and remove distutils workaround.	2016-04-15 09:40:41 -05:00

README.md

CloudRoast, CloudCAFE Test Repo

 (----) (----)--)
  (--(----)  (----) --)
(----) (--(----) (----)
-----------------------
\                     /
 \                   /
  \_________________/    
     )\ `   `(` `
     ( ) ` )' )  \_
    (   )  _)  \   )
  ) )   (_  )   ,  (
  (  ,  )   (   (
    (  (    )    )
  === CloudRoast ===
= A CloudCAFE Test Repository =

CloudRoast is a rich, full bodied blend of premium roasted automated test cases. CloudRoast tests are based on the expanded unittest driver in the Open CAFE Core and built using the CloudCAFE Framework.

CloudRoast tests support smoke, functional, integration, scenario and reliability based test cases for OpenStack. It is meant to be highly flexible and leave the logic of the testing in the hands of the test case developer while leaving the interactions with OpenStack, various resources and support infrastructure to CloudCAFE.

Installation

CloudRoast can be installed with pip from the git repository after it is cloned to a local machine.

First follow the README instructions to install the CloudCAFE Framework
Clone this repository to your local machine
cd to the root directory in your cloned repository.
Run pip install . --upgrade and pip will auto install all other dependencies.

Configuration

CloudRoast runs on the CloudCAFE Framework using the cafe-runner. It relies on the configurations installed to: ${HOME}/.cloudcafe/configs/${PRODUCT} by CloudCAFE.

At this stage you will have the Open CAFE Core engine, the CloudCAFE Framework implementation and the Open Source automated test cases. You are now ready to:

Execute the test cases against a deployed Open Stack. or
Write entirely new tests in this repository using the CloudCAFE Framework.

Logging

If tests are executed with the built-in cafe-runner, runtime logs will be output to $HOME/.cloudcafe/logs/$PRODUCT/$CONFIGURATION/$TIME_STAMP

In addition, tests built from the built-in CAFE unittest driver will generate csv statistics files in $HOME/.cloudcafe/logs/$PRODUCT/$CONFIGURATION/statistics for each and every execution of each and every test case that provides metrics of execution over time for elapsed time, pass/fail rates, etc...

Basic CloudRoast Package Anatomy

Below is a short description of the top level CloudRoast Packages.

cloudroast

This is the root package for all automated tests. This namespace is currently required by the cafe-runner for any Test Repository plug-in.

identity

OpenStack Identity Service cafe-runner plug-in test cases.

compute

OpenStack Compute Service cafe-runner plug-in test cases.