/build-monitor-clj

as it says on the tin...

Primary LanguageJavaScriptEclipse Public License 1.0EPL-1.0

build-monitor-clj Build Status

A Clojure application designed to run an interesting build monitor.

It uses the cctray.xml format which is supported by nearly all CI servers. (I'm looking at you Bamboo)

See a demo at http://build-monitor-clj.herokuapp.com

How to Run

The build monitor runs on port 5000 (by default).

export CCTRAY_URL=https://builds.apache.org/cc.xml
lein ring server

Config

All configuration variables are read from the environment (see http://12factor.net/config). Under *nix operating systems you can use the export command and under Windows the set command to easily set this values in a start up script.

Name Required? Default Value Description Example
CCTRAY_URL Yes N/A The absolute url to the cctray.xml file to parse https://builds.apache.org/cc.xml
INCLUDED_PROJECTS No ".*" (i.e. Include everything) A comma separated list of projects to include, this list is matched against the raw project name and may include regular expressions "foo service, .*environment, test.*"
EXCLUDED_PROJECTS No nil (i.e. Exclude nothing) A comma separated list of projects to exclude, this list is matched against the raw project name and may include regular expressions "sandbox environment, test external stuff"
PORT No 5000 The port to start on, if this is not a valid port number you'll get an error while trying to start the application 1337

Contributing

CC Tray XML Spec

See https://github.com/robertmaldon/cc_dashboard/blob/master/README.md#summary

TODO

  • Themeable - Zero broken/building builds screen (http-status-cats, keep calm and keep committing, Days since last accident)
  • Themeable - Build status change noises
  • D3 screen

License

Copyright © 2014 Ste Cowley, Joe Wright, Chris Martin and friends (insert your name here!)

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.