Skip to content

tc-radiate/tc-radiate

Repository files navigation

Radiator for TeamCity

Features

  • Self-hostable on Github under youraccount.github.io/tc-radiate - just fork this repo for your own URL, edit the Settings.js and open that URL on your big screen
  • List ordered by priority: Uninvestigated Failure > Investigated Failure > Running > Success > Paused (within each group sorted by recency, big picture always shows highest priority)
  • Plays a sound on a new failure (when not wanted can be muted persistently)
  • Very easy to customize images and sounds (supports remote URLs with fallback to local ones)
  • Shows author names of failed changes (when no changes shows who triggerred the build)
  • Shows investigator name and his comment, if provided
  • Auto update - any changes pushed to gh-pages branch get picked up automatically after a while.
  • Supports 'no guest account' setups of TeamCity, with no credentials saved in code (uses the standard browser's basic authentication, so you can save credentials in your browser, or just keep entering them)

Working monitors

An example is here: https://tc-radiate.github.io/tc-radiate/,
but to be able to see it talking securely to your TeamCity, you should create your own domain by forking. To do that, follow the Setup.

Setup

  1. Fork this repo. This will give you a web-page: youraccount.github.io/tc-radiate
  2. Edit relevant variables in Settings.js.
  3. Set your TeamCity to allow cross-domain requests from the youraccount.github.io domain (see TeamCity Doc). Alternatively, use a Proxy.
  4. Enjoy your radiator at youraccount.github.io/tc-radiate

Testing local changes

To test your changes on your local machine, you need to open the index.html file in a browser with disabled cross-domain security. In the main folder there are open-in-*-for-local-development.cmd files, which help you to do this. Please read and follow instructions displayed during execution.

Proxy

This is not advised if you can set up CORS in TeamCity (see Configuration), but in the absence of other choice you can use a proxy web application to request the TeamCity web services. In the 'proxies' folder there is an example of a an ASP.NET proxy which needs to be ran on IIS. If you want to use this, just copy it into the root tc-radiate folder and hook the folder up to an IIS website.