performa/shaker
Code Issues Proposed changes
Distributed data-plane performance testing tool
300 Commits 1 Branch 27 Tags 3.5 MiB
Python 91%
HTML 8%
Shell 0.8%
Dockerfile 0.2%
be09a65029
Go to file
Ilya Shakhat be09a65029 Fix docs gate and rtd build 
Docs gate was broken due to https://sourceforge.net/p/docutils/bugs/301/

Change-Id: Icdf97e9547da6df0a9b12e1c61413de6690b3ac3
2016-12-14 12:51:10 +04:00
doc/source Add Ubuntu Xenial template for Shaker image builder 2016-10-13 22:17:38 +03:00
etc Add Ubuntu Xenial template for Shaker image builder 2016-10-13 22:17:38 +03:00
shaker Add Ubuntu Xenial template for Shaker image builder 2016-10-13 22:17:38 +03:00
tools Move scenarios from networking/ to openstack/ 2016-04-18 11:57:14 +03:00
.dockerignore Pack Shaker into container 2016-08-04 15:36:41 +03:00
.gitignore Initial commit 2015-01-28 18:56:01 +03:00
.gitreview Update .gitreview for new namespace 2015-10-17 22:38:47 +00:00
.testr.conf Include tests into the package 2015-07-09 11:12:29 +03:00
config-generator.conf Fix config processing for oslo.log 2015-03-03 17:38:25 +03:00
doc-requirements.txt oslo.log is required for RTFD build 2016-10-04 19:20:44 +03:00
Dockerfile Pack Shaker into container 2016-08-04 15:36:41 +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 Doc update 2016-08-19 17:22:22 +03:00
readthedocs.yml Fix docs gate and rtd build 2016-12-14 12:51:10 +04:00
requirements-agent.txt Update requirements and pin pyzmq 2015-11-12 14:05:16 +03:00
requirements.txt Work with OpenStack python client in a modern manner 2016-04-26 10:12:24 +03:00
rtd-requirements.txt Fix docs gate and rtd build 2016-12-14 12:51:10 +04:00
setup-agent.cfg Add separate setup config for building pyshaker-agent 2015-04-28 13:05:42 +03:00
setup.cfg Add Python 3.5 classifier and venv for shaker 2016-09-05 10:14:36 +08:00
setup.py Update requirements and pin pyzmq 2015-11-12 14:05:16 +03:00
test-requirements.txt Fix docs gate and rtd build 2016-12-14 12:51:10 +04:00
tox.ini Fix docs gate and rtd build 2016-12-14 12:51:10 +04:00

README.rst

Shaker

The distributed data-plane testing tool built for OpenStack.

Shaker wraps around popular system network testing tools like iperf, iperf3 and netperf (with help of flent). Shaker is able to deploy OpenStack instances and networks in different topologies. Shaker scenario specifies the deployment and list of tests to execute. Additionally tests may be tuned dynamically in command-line.

Features

  • User-defined topology via Heat templates
  • Simultaneously test execution on multiple instances
  • Interactive report with stats and charts
  • Built-in SLA verification

Deployment Requirements

  • Shaker server routable from OpenStack cloud
  • Admin-user access to OpenStack API is preferable

Run in Python Environment

$ pip install pyshaker
$ . openrc
$ shaker-image-builder
$ shaker --server-endpoint <host:port> --scenario <scenario> --report <report.html>``
where:
  • host and port - host and port of machine where Shaker is deployed
  • scenario - the scenario to execute, e.g. openstack/perf_l2 ( catalog)
  • <report.html> - file to store the final report

Full list of parameters is available in documentation.

Shaker in Container

Shaker is available as container at Docker Hub at shakhat/shaker

$ docker run -p <port>:<port> -v <artifacts-dir>:/artifacts shakhat/shaker --scenario <scenario> --server-endpoint <host:port>
  --os-auth-url <os-auth-url> --os-username <os-username> --os-password <os-password> --os-project-name <os-project-name>
where:
  • host and port - host and port on machine where Shaker is deployed
  • artifacts-dir - where to store report and raw result
  • scenario - the scenario to execute, e.g. openstack/perf_l2 ( catalog)
  • os-XXX - OpenStack cloud credentials

Links