performa/shaker
Code Issues Proposed changes
Distributed data-plane performance testing tool
68 Commits 1 Branch 27 Tags 3.5 MiB
Python 91%
HTML 8%
Shell 0.8%
Dockerfile 0.2%
a8e50eacc4
Go to file
Ilya Shakhat a8e50eacc4 Fix config processing for oslo.log 
Change-Id: Ib63cf80560f7d9a0a6dc9c4e04015b098511d4a5
2015-03-03 17:38:25 +03:00
bin Do not install numpy on agent machines 2015-02-12 13:57:05 +03:00
doc/source Initial commit 2015-01-28 18:56:01 +03:00
etc Fix config processing for oslo.log 2015-03-03 17:38:25 +03:00
scenarios Push agent_id from the deployment engine 2015-03-03 13:25:02 +03:00
shaker Fix config processing for oslo.log 2015-03-03 17:38:25 +03:00
tests Refactor executors build command lines 2015-03-02 18:27:36 +03:00
tools Initial commit 2015-01-28 18:56:01 +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 Cleanup iperf graph reporting 2015-02-25 18:15:38 +03:00
requirements.txt Use oslo.log lib instead of incunator code 2015-03-03 16:14:19 +03:00
setup.cfg Fix config processing for oslo.log 2015-03-03 17:38:25 +03:00
setup.py Sync requirements with global list 2015-02-02 13:38:38 +03:00
test-requirements.txt Apply bootstrap styles to the report template 2015-02-16 22:25:51 +03:00
tox.ini Apply bootstrap styles to the report template 2015-02-16 22:25:51 +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 linked into scenario, spawns instances, distributes tasks among instances and generates report in HTML format.

All server parameters

  • server_endpoint = <None> - Address for server connections (host:port) (string value)
  • os_auth_url - Authentication URL, defaults to env[OS_AUTH_URL]. (string value)
  • os_tenant_name - Authentication tenant name, defaults to env[OS_TENANT_NAME]. (string value)
  • os_username - Authentication username, defaults to env[OS_USERNAME]. (string value)
  • os_password - Authentication password, defaults to env[OS_PASSWORD]. (string value)
  • os_region_name = RegionOne - Authentication region name, defaults to env[OS_REGION_NAME]. (string value)
  • external_net - Name or ID of external network. If not set the network is chosen randomly. (string value)
  • image_name = shaker-image - Name of image to use. The default is created by shaker-image-builder (string value)
  • flavor_name = shaker-flavor - Name of image flavor. The default is created by shaker-image-builder (string value)
  • scenario = <None> - Scenario file name (string value)
  • report = <None> - Report file name. If not specified print to stdout (string value)
  • report_template = shaker/engine/report.template - Report template file name (Jinja format) (string value)