performa/shaker
Code Issues Proposed changes
Distributed data-plane performance testing tool
144 Commits 1 Branch 27 Tags 3.5 MiB
Python 91%
HTML 8%
Shell 0.8%
Dockerfile 0.2%
68a5540581
Go to file
Jenkins 68a5540581 Merge "Change style of docs to standard RTFD"
2015-05-08 14:53:45 +00:00
doc/source Change style of docs to standard RTFD 2015-05-08 17:28:46 +03:00
etc Change style of docs to standard RTFD 2015-05-08 17:28:46 +03:00
scenarios Terminate if accommodation is not satisfied 2015-04-24 18:32:57 +03:00
shaker Handle SIGINT while agents are joining the quorum 2015-05-08 17:06:08 +03:00
tests Handle SIGINT while agents are joining the quorum 2015-05-08 17:06:08 +03:00
tools Fix build for pyshaker-agent 2015-04-28 16:25:20 +03:00
.gitignore Initial commit 2015-01-28 18:56:01 +03:00
.gitreview Apply bootstrap styles to the report template 2015-02-16 22:25:51 +03:00
.testr.conf Initial commit 2015-01-28 18:56:01 +03:00
config-generator.conf Fix config processing for oslo.log 2015-03-03 17:38:25 +03:00
LICENSE Initial commit 2015-01-28 18:56:01 +03:00
openstack-common.conf Use oslo.log lib instead of incunator code 2015-03-03 16:14:19 +03:00
README.rst Update readme file 2015-03-24 19:21:32 +03:00
requirements-agent.txt Add separate setup config for building pyshaker-agent 2015-04-28 13:05:42 +03:00
requirements.txt Use MAC as default agent id 2015-04-20 17:02:55 +03:00
setup-agent.cfg Add separate setup config for building pyshaker-agent 2015-04-28 13:05:42 +03:00
setup.cfg Update readme file 2015-03-24 19:21:32 +03:00
setup.py Sync requirements with global list 2015-02-02 13:38:38 +03:00
test-requirements.txt Change style of docs to standard RTFD 2015-05-08 17:28:46 +03:00
tox.ini Detect lost agents 2015-04-07 14:01:14 +03:00

README.rst

Shaker

Shake VMs with our sheer-class tests!

Installation

The tool consists of a single server running on master node and set of dynamically provisioned agents. In order to run the server needs to know OpenStack parameters (credentials, auth_url), they can be set via environment (e.g. by sourcing openrc file) or via parameters.

To install:
  1. git clone git://git.openstack.org/stackforge/shaker
  2. python setup.py install - installs the tool and all its python dependencies
  3. shaker-image-builder - builds image for agent VMs inside OpenStack

Note: image builder is able to create Nova flavor optimized for the image and this requires admin user privileges. However if the flavor is already exists then it can be provided via flavor-name config parameter and the tool executed from an ordinary user.

How to run

  1. shaker --server-endpoint <host>:<port> --scenario <scenario-file> --report <report-file>

During the run the tool deploys topology, spawns instances, distributes tasks among instances and generates report in HTML format.

Links