Skip to content

Latest commit

 

History

History
122 lines (77 loc) · 7.92 KB

README.md

File metadata and controls

122 lines (77 loc) · 7.92 KB

Jenkins CI Build Monitor Plugin

Build Monitor Plugin provides a highly visible view of the status of selected Jenkins jobs.

It easily accommodates different computer screen sizes and is ideal as an Extreme Feedback Device to be displayed on a screen on your office wall. (Inspired by the no longer maintained RadiatorView plugin).

Build Status Acceptance Tests Status Stories in Backlog

Have a question? Perhaps it's already been answered - check the FAQ section below.

Features

I'd like to keep the plugin as simple as possible, yet useful and effective.

Current functionality of the Build Monitor plugin:

  • Displays the status and progress of selected jobs. The view is updated automatically every couple of seconds using AJAX, so no "Enable Auto Refresh" needed.
  • Displays the names of people who might be responsible for "breaking the build".
  • Supports the Claim plugin, so that you can see who's fixing a broken build
  • Supports View Job Filters, so that you can easily create Build Monitors for "slow builds", "only failing", etc.
  • Supports Build Failure Analyzer, so that you know not only who, but also what broke the build; learn more
  • Supports CloudBees Folders Plugin, so that you can have project- and team-specific nested Build Monitors; learn more
  • The number of columns and size of the font used is easily customisable, making it trivial to accommodate screens of different sizes.
  • UI configuration is stored in a cookie, making it possible to display different number of columns and using different font size on each of the screens at your office.
  • Can work in a colour-blind-friendly mode; learn more

All the previous releases together with their change logs are listed here.

Your feedback matters!

Do you find Build Monitor useful? Give it a star! ★

Found a bug? Raise an issue or submit a pull request (start with this mini-dev guide, it might come in handy).

Have feedback? Let me know on twitter: @JanMolak

Flattr Button

Setting up

Setting up

Simple, right? :-) You can have as many Build Monitor Views as you want - the most popular approach is to have one per team or one per project.

A picture is worth a thousand words

Adding jobs Three columns view Supports Claim and Build Failure Analyzer plugins Colour-blind mode

Roadmap and work in progress

To stay up-to-date with the project news - follow @JanMolak on twitter.

If you'd like to know what's coming next - have a look at the project's kanban board. Here's how the columns work:

  • Ideas - ideas up for discussion. If you'd like to see any of them making it into the Build Monitor project - vote on them or submit a pull request.
  • Backlog - features most wanted by the Build Monitor Community. I'll get them done as soon as I have a spare moment. Feel free to help out! :-)
  • In progress - stuff I'm currently working on and will make it into the next release.
  • Done - done and deployed. Grab the latest version from your Jenkins Update Centre or the Releases page.

If you'd like to get hold of the latest and greatest build of the Build Monitor Plugin before it's available in the Jenkins Update Centre, you can download it from the SmartCode Open-Source Jenkins CI server, kindly hosted by CloudBees.

built on dev@cloud

(A)TDD

If you'd like to understand more about the logic behind the Build Monitor Plugin, have a look at the tests that drove the design.

FAQ

How do I let my teammates know that I'm fixing a broken build?

By claiming it. Build Monitor supports Jenkins Claim Plugin, so once you have it installed, enable "Broken build claiming" in the "Post-build actions" of your Jenkins job. From now on you'll be able to claim any further broken builds and Build Monitor will pick it up.

You might also be interested in a script that enables claiming on all your Jenkins jobs.

How do I know what broke the build?

Wouldn't it be great to know what made your build fail? Well of course it would. Build Monitor supports Jenkins Buld Failure Analyzer Plugin so get it, teach it and Build Monitor will tell you what the Failure Analyzer found out.

I have too many jobs on one screen, what should I do?

You have several options here:

  1. review the granularity of your jobs: If you have too many low-level jobs displayed on one screen, consider consolidating them using Promoted Builds Plugin or MultiJob Plugin
  2. use job filters: Build Monitor supports Jenkins View Job Filters Plugin, if you have it installed
  3. get a bigger screen ...

Red and green colours are lovely, but I'm colour blind ...

There's a colour blind mode you can enable in the Settings

Known Limitations

Browser support - Modern web browsers only

To avoid unnecessary complexity when implementing the view layer I decided to use CSS 3 flexbox. The standard is currently supported by most modern web browsers, so if your browser doesn't support this feature - consider upgrading :)

License: MIT

Open Source Software Used

Inspired by

No longer maintained Radiator View Plugin