ClusterRunner makes it easy to parallelize test suites across your infrastructure in the fastest and most efficient way possible.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
bin
conf
examples/directory job Implement max_executors_per_slave job conf setting Jan 6, 2015
test
windows
.dockerignore Fix autoversion bugs in release steps (#435) Apr 27, 2018
.gitignore
.travis.yml
Dockerfile
Jenkinsfile
LICENSE First commit - seeding ClusterRunner repo with initial version Oct 21, 2014
Makefile
README.md Fix a tiny typo Mar 26, 2018
appveyor.yml
clusterrunner.yaml
dev-requirements.in
dev-requirements.txt
pylintrc
requirements.in Add pip-tools to manage dependency versioning (#444) Jun 26, 2018
requirements.txt
setup.py Deploy shell scripts to /var/lib/clusterrunner/bin (#430) Apr 24, 2018

README.md

Project Status Build Status Build status Coverage Status

ClusterRunner

ClusterRunner makes it easy to execute test suites across your infrastructure in the fastest and most efficient way possible.

By using ClusterRunner in your testing pipeline, you will be able to easily:

  • Make long-running, single-threaded test jobs run in parallel.
  • Consistently utilize 100% of your testing infrastructure.
  • Get test feedback faster.
  • Completely isolate tests from each other, avoiding nasty global state.

The entire process of installing, initializing, and executing tests through ClusterRunner should take about 8 minutes!

Give it a shot by starting at our documentation site.

Read the Docs

You can find all our official documentation at clusterrunner.com.

For a quick visual overview, check out the infographic we presented at the PyCon 2015 poster session:

Visualize

ClusterRunner currently has no built-in UI, but its extensive API allows you to create detailed dashboards so you can monitor your cluster and see what it's doing.

We've open-sourced a few of the dashboards we use internally at Box for monitoring our own clusters. Check out the ClusterRunner-Dashboard repo for the code and documentation.

Contribute

We ❤️ external contributors! You can run ClusterRunner entirely locally and it has a comprehensive functional test suite, so it's easy to get started. Take a look at our open issues to get an idea of where you can help out.

Get Help

We're happy to answer any questions you have around setting up ClusterRunner in your own org. Create a new issue on this repo, or email oss@box.com and be sure to include "ClusterRunner" in the subject.

Copyright and License

Copyright 2014 Box, Inc. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.