Skip to content

elrob/build-mon

Repository files navigation

build-mon

Build Status

A simple build monitor to display the status of Visual Studio Online builds and releases.

Screenshot

Usage

  • Find your account name and project name from your Visual Studio Online url:

      https://{VSO_ACCOUNT_NAME}.visualstudio.com/{VSO_PROJECT_NAME}
    
  • Obtain a personal access token for Visual Studio Online with the following permissions boxes ticked:

    • Build (read) for displaying status of builds
    • Release (read) for displaying status of releases
    • Code (read) for displaying commit messages (optional)

Run with Java

  • Install Java

  • Download the release jar file

  • Run app:

      java -jar build-mon-0.2.0-standalone.jar "{VSO_ACCOUNT_NAME}" "{VSO_PROJECT_NAME}" "{VSO_PERSONAL_ACCESS_TOKEN}"
    
  • Visit localhost:3000

Run with Leiningen

  • Install Leiningen

  • Clone this repository

  • Run app:

      lein run "{VSO_ACCOUNT_NAME}" "{VSO_PROJECT_NAME}" "{VSO_PERSONAL_ACCESS_TOKEN}"
    
  • Visit localhost:3000

Run on Heroku

A Procfile is included for simple deployment to Heroku.

  • Create a new app in Heroku.

  • Push this repository to it.

  • Set the Config Variables in the app settings:

      VSO_ACCOUNT_NAME
      VSO_PROJECT_NAME
      VSO_PERSONAL_ACCESS_TOKEN
    

Development

Run tests:

lein midje [:autotest]

Run code analysis and tests:

lein test

TODO:

  • reinstate error handling on front end (was removed from refresh.js) - VSO api sometimes goes down and it is useful to get some feedback in the browser