waylon

Waylon is a dashboard to display the status of your Jenkins builds.

• Project page: http://rogerignazio.com/projects/waylon
• Source code: https://github.com/rji/waylon

Overview

• Displays only the desired jobs from one or more Jenkins instances
• Displays build stability for each job (sunny, cloudy, raining)
• Groups jobs by building, failed, and successful, and displays job counts for each
• Mark a failed build as 'under investigation' (requires the description-setter plugin)
• Multiple views allows for multiple teams to utilize a single Waylon install
• Nirvana mode displays a calming image of Oregon if all your jobs are green

Setup

Clone the repo:

git clone https://github.com/rji/waylon

Modify config/waylon.yml to point to your Jenkins install, and enter any job names that you wish to display. For the most part, it's self-explanatory, but here's an example for a few of Puppet Labs' FOSS projects:

---
config:
    - refresh_interval: 60  # page refresh interval (in seconds)
views:
    - 'Puppet Labs - FOSS':
        - https://jenkins.puppetlabs.com:
            - username: 'YOUR_USERNAME'
            - password: 'YOUR_PASSWORD'
            - jobs:
                - 'Puppet-Specs-master'
                - 'Facter-Specs-master'
                - 'Hiera-Specs-master'

Deploy

You can deploy locally, on your LAN, or if you have a public Jenkins instance, or push the whole thing to Heroku.

For development, running rackup will launch the app with WEBrick on port 9292:

$ bundle exec rackup
[2014-05-15 10:36:33] INFO  WEBrick 1.3.1
[2014-05-15 10:36:33] INFO  ruby 2.1.1 (2014-02-24) [x86_64-darwin13.0]
[2014-05-15 10:36:33] INFO  WEBrick::HTTPServer#start: pid=41331 port=9292

For deploying the app, you might consider Unicorn, modifying config/unicorn.rb as needed. In it's absolute simplest form, this is:

$ bundle exec unicorn -c config/unicorn.rb
I, [2014-05-15T10:38:08.425598 #41334]  INFO -- : listening on addr=0.0.0.0:8080 fd=9
I, [2014-05-15T10:38:08.425707 #41334]  INFO -- : worker=0 spawning...
I, [2014-05-15T10:38:08.426279 #41334]  INFO -- : worker=1 spawning...

Screenshots

Credits

This application makes use of and/or re-distributes the following open source software:

• Sinatra
• Bootstrap
• jQuery
• jenkins_api_client

This application also includes the following content that was released under the Creative Commons Attribution (CC BY) license:

• GLYPHICONS
• Day 105: Oregon Coast Range by Loren Kerns
• Mt. Hood, Oregon by tsaiproject
• Multnomah Falls by John Tregoning
• 101_1812 by Randall Booth
• Central Oregon Landscape by Michael McCullough
• Oregon Autumn Part 4 by Ian Sane
• Astoria, Oregon by Linda Tanner