Monitor and display the status of your builds on your Chumby.
The Chumby is a device that can connect to the internet and run many applications.
HudsonMonitor is a Chumby application created by ToolsCloud to monitor your Hudson Continuous Integration server builds. The application is open sourced under the GPL license and the source code can be found here. The application is provided as-is and there is no warranty for this free software.
You can find the HudsonMonitor application at the Chumby App Store and install it on your Chumby for free.
The first step to use the HudsonMonitor in your Chumby is to get the URL for just the latest builds RSS from your Hudson server, that can be found at the bottom of the Hudson server main page.
Before setting this URL in the Chumby application, note that since HudsonMonitor is a Flash application, the server that is providing the RSS *must* allow Flash access to that feed by using a "crossdomain.xml" file - you can read more about this at:
- External data not accessible outside a Macromedia Flash movie's domain
- Security Changes in Macromedia Flash Player 7
The crossdomain.xml file should be at the root of your http server. So, in order to allow your Chumby to access the Jenkins RSS you have to put a crossdomain.xml file like this one in your Jenkins server.
When you have set your Hudson server, go to the configuration screen of the HudsonMonitor in your Chumby web page and set the URL of the RSS you got for the latest builds.
Done! Now, when a build is broken, your Chumby will let you know.
You don't own a Chumby? You can still use the version of the HudsonMonitor hosted here. Just grab an old computer and let it act as your build monitor. And don't forget to add the toolscloud.com domain to your crossdomain.xml file, if you are going to use this version.
Additional information about this tool can be found on the Hudson Monitor for Chumby web site .
Additional instructions:
If your Jenkins requires authentication to access the RSS or if you run your Jenkins server through HTTPS, the Hudson monitor will not be able to get the RSS feed directly from Jenkins. One possible solution for this is to copy the RSS from time to time to a security free area that is accessible via HTTP. You can even do this using Jenkins! Here is how to do it:
- Create a new build in Jenkins that is executed from time to time, or, better yet, is fired when any other build finishes;
- In the command field of this build, type something like this:
wget --no-check-certificate --save-cookies /temp/hudson-authentication-cookie \
‐‐output‐document "-" \
'https://your.server.com/hudson/j_acegi_security_check?j_username=a_user&j_password=a_password&remember_me=true' >/dev/null
wget --no-check-certificate --load-cookies /temp/hudson-authentication-cookie \
-O /var/www/rss/rssLatest https://your.server.com/hudson/rssLatest
Note that you have to adapt these commands to your environment, setting the right server address, folders, user and password.
These commands will copy the RSS from your secure server to an unsecure area, so it can be accessed by the flash application. Use the unsecure URL in your Chumby's Hudson Monitor and you can make it work with a secure Hudson server.