Dashr is a monitoring tool for Jenkins builds

• a Jenkins server
• a big monitor/television

• A good place to learn about setting up git is [here][git-github]
• Git [home][git-home] (download, documentation)

• Get [Node.js][node-download].
• Install the tool dependencies (npm install)

Dashr is a monitoring tool using data from jenkins rest api. By entering a valid url the data of your project can be visualised with your own preferences.

• The application filesystem layout structure is based on the [angular-seed] project.
• There is no dynamic backend (no application server) for this application. Instead we fake the an application server by fetching static json files.
• Read the Development section at the end to familiarize yourself with running and developing an angular application.

The url that is used can change in depth. Using depth 0 returns less information then a higher depth, and is therefor faster. The depth is given in the url, for example:

https://ci.jenkins-ci.org/view/All/api/json?pretty=true&depth=0 <---Change depth here

When using depth 0 the only information that can be displayed is the status and the name of a job. The rest will return 'none'. When using depth 1 a lot more information is available. In preferences.js each piece of information can be set to 'show' or 'hide'. Other preferences:

• Font Size: Values: ["s", "m", "l"] (small, medium, large) Description: Scales all text
• Health Report Size: Values: ["s", "m", "l"] (small, medium, large) Description: Scales the health report image.
• Boxes Inline Values: [1, 2, 3, 4, 6, 12] Description: Defines how many boxes will be displayed horizontally 1, 2, 3, 4, 6 or 12
• Box Height Values: [0..infinite] Description: Sets the height for all boxes

The following docs describe how you can test and develop further this application.

The application relies upon various node.js tools, such as Bower, Karma and Protractor. You can install these by running:

npm install

This will also run bower, which will download the angular files needed for the current step of the tutorial.

Most of the scripts described below will run this automatically but it doesn't do any harm to run it whenever you like.

• Navigate to the project folder in the command line
• Run npm start
• Navigate your browser to http://localhost:8000/app/index.html to see the app running in your browser.
• When the data keeps loading there might be a problem with authentication. When this message pops up in console: "No 'Access-Control-Allow-Origin' header is present on the requested resource." the CORS requests must be enabled in the browser.

There are different solutions for hosting Dashr. One easy and fast solution is NGINX.

1. Download and unpack NGINX (http://nginx.org/en/download.html)

2. Copy the 'app' folder to NGINX/html

3. And start NGINX.

• Henk Jurriens @henkjurriens
• Chantal Steur @steur36
• Patrick Verhoeven