Name: shakedown
Owner: DC/OS
Description: DC/OS test harness
Created: 2016-02-19 23:47:51.0
Updated: 2018-04-23 15:48:12.0
Pushed: 2018-05-03 19:23:46.0
Size: 404
Language: Python
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
DC/OS test harness.
*A shakedown is a period of testing or a trial journey undergone by a ship, aircraft or other craft and its crew before being declared operational.
? https://en.wikipedia.org/wiki/Shakedown_(testing)*
Shakedown requires Python 3.4+.
The recommended Shakedown installation method is via the PyPI Python Package Index repository at https://pypi.python.org/pypi/dcos-shakedown. To install the latest version and all required modules:
pip3 install dcos-shakedown
dcos-shakedown has a number of dependencies which need to be available. One of those dependencies, the cryptography module requires a number of OS level libraries in order to install correctly which include: build-essential libssl-dev libffi-dev python-dev
. For environments other than linux please read Stackoverflow. On a new ubuntu environment the following should install dcos-shakedown.
apt-get update
apt-get install python3 python3-pip build-essential libssl-dev libffi-dev python-dev
pip3 install dcos-shakedown
To pull and install from our master
branch on GitHub:
clone https://github.com/dcos/shakedown.git
hakedown
install -r requirements.txt && pip3 install -e .
Or if you do not wish to pin to a version of dcos-cli
:
install -r requirements-edge.txt && pip3 install -e .
If you'd like to isolate your Shakedown Python environment, you can do so using the virtualenv tool. To create a new virtual environment in $HOME/shakedown
:
install virtualenv
ualenv $HOME/shakedown
ce $HOME/shakedown/bin/activate
install dcos-shakedown
This virtual environment can then be activated in new terminal sessions with:
source $HOME/shakedown/bin/activate
shakedown --dcos-url=http://dcos.example.com [options] [path_to_tests]
--dcos-url
is required.~/.shakedown
TOML file (command-line takes precedence)shakedown --help
is your friend.Shakedown can be run against multiple DC/OS clusters in parallel by setting the DCOS_CONFIG_ENV
environmental variable to a unique file, eg:
DCOS_CONFIG_ENV='shakedown-custom-01.toml' shakedown --dcos-url=http://dcos.example.com [options] [path_to_tests]
Shakedown is a testing tool as well as a library. Many helper functions are available via from shakedown import *
in your tests. See the API documentation for more information.
Shakedown is licensed under the Apache License, Version 2.0. For additional information, see the LICENSE file included at the root of this repository.
Please report issues and submit feature requests for Shakedown by creating an issue in the DC/OS JIRA with the “Shakedown” component (JIRA account required).
See the CONTRIBUTING file in the root of this repository.