Wednesday, January 9, 2008

JRuby / Ruby Continuous Integration with Hudson

Hudson is a great tool for your continuous integration needs. It's very easy to setup and can run/monitor multiple types of tasks. Some have used it for Python and this blog entry will show you how to get Hudson setup quickly for running your Ruby or JRuby tests. (including reporting)

(This step-by-step is assuming you have Java installed on the machine you are using.)

First we'll need to download Hudson here and start our Hudson instance: (just grab the latest stable release)
[sourcecode language='css']
java -jar hudson.war
(see Hudson site for other deployment options.)

Next, grab the CI::Reporter gem we'll need for test results xml formatting :
[sourcecode language='css']
gem install -y ci_reporter
OR for JRuby
jruby -S gem install -y ci_reporter

UPDATE: Make sure you insert the following lines in your Rakefile:
[sourcecode language='ruby']
require rubygems
gem ci_reporter
require ci/reporter/rake/test_unit

Hit your running Hudson instance: http://localhost:8080/ and configure a new build by clicking the "New Job" link. Enter the name of your build and select the "Build a free-style software project" (click OK.)

Configure your SCM data, then scroll down to the "Build" section and select either "Execute Windows batch command" (windows) or "Execute shell" (*nix). This is where we'll call our 'rake test' task using the CI::Reporter gem and specifying a spot for the report XMLs to live:
[sourcecode language='css']
//rake ci:setup:testunit test CI_REPORTS=results
OR for JRuby
//jruby -S rake ci:setup:testunit test CI_REPORTS=results

UPDATE: When using Subversion, it will check things out into a sub directory of your "workspace" (found ~<user running hudson>/.hudson/jobs/<your job name>/workspace) If you are checking out 'trunk' and don't specify a different name for the directory, your shell execution settings should look like this:
(be sure to know how your SCM works before applying the following)
[sourcecode language='ruby']
cd trunk
//rake ci:setup:testunit test CI_REPORTS=results

This will setup the CI::Reporter and place the XMLs in the "results" directory for us.

We are almost done, now under the "Post-build Actions" section, check the "Publish JUnit test result report" box and enter the following in the "Test report XMLs" field:
[sourcecode language='css']

Now click Save and go test it out... Select your newly created job from the Dashboard.

Click the "Build Now" link... done. After a few builds you should see a graph on the job's main page that looks like this:

If you have a failure, you can drill down by clicking the "Test Result" link on an individual build's page.

Clicking on an individual failed test's name will show you the output from that failure

That's all it takes, pretty simple and works like a charm. Now you can go back and play with the other settings Hudson has, triggers, scheduling, job artifacts, notifications... you could even have a job that prepares a build by generating all your static content so your server doesn't have to take the initial hit after startup. (web projects)

If interested, there is a way to create plugins for Hudson.


Mike said...

Sweet post. I think you might have left out:

1. To use CI::Reporter, simply add the following lines to your Rakefile:

require 'rubygems'
gem 'ci_reporter'
require 'ci/reporter/rake/rspec' # use this if you're using RSpec
require 'ci/reporter/rake/test_unit' # use this if you're using Test::Unit

Mike McKinney said...

Thanks Mike, updated the post...

Matt said...

Outstanding. Hudson is truly a sweet tool and I'm not at all surprised to see you using it with your Ruby fetish. ;-)

Mike McKinney said...

Some updates have been made based on comments from Mike Herrick and others using this setup procedure. Let me know if you run into other issues with this post and I'll update for future reference.

Stephen Connolly said...

The note about the subfolder when using a SCM does not apply to _all_ scms. But Subversion is one of the SCMs that forces hudson to put the files in a subfolder

Mike McKinney said...

Thanks Stephen, updated.

Vladimir Sizikov said...

Excellent post. I hope it would help to set up JRuby's own Hudson builds system with proper test reports.

RickMoynihan said...

Thanks for this, it works great.

Ruby CI options « Fiji Ecuador Seattle Greece Montana said...

[...] [...]

Alex Pimenov said...

Have you looked at our Parabuild at ? It is a bit easier to set up and it provides more extensive statistics.

Tom C said...

When attempting to run the rake command, it tries to run the tests but eventually stops with an error along the lines of "could not find/load file" and some messages about ActiveSupport, etc.

It seems that the 1.5.1 version of CI::Reporter claims to have fixed a similar error.

I'm running JRuby 1.1.3 and also tried 1.1.4 but with the same result.

sandeep saxena said...

i really enjoyed the article.the article is very useful and im satisfied to read this.its help me to study also.
DevOps certification in Chennai
DevOps Training in Chennai
DevOps course in Chennai
Data Science Training in Chennai
AWS training in chennai
AWS course in chennai

Manipriyan said...

Thanks for sharing

AWS Training in Chennai

Blueprism Training in Chennai

Uipath Training in Chennai

Rathinam said...

Well, do! recently I saw your pretty post and It is good with useful details. Thank you...
Placement Training in Chennai
Best placement Training institutes in Chennai
Power BI Training in Chennai
Job Openings in Chennai
Pega Training in Chennai
Soft Skills Training in Chennai
JMeter Training in Chennai
Tableau Training in Chennai
Appium Training in Chennai
Placement Training in Porur
Placement Training in Anna Nagar

Chris Hemsworth said...

I have been reading for the past two days about your blogs and topics, still on fetching! Wondering about your words on each line was massively effective. Techno-based information has been fetched in each of your topics. Sure it will enhance and fill the queries of the public needs. Feeling so glad about your article. Thanks…!
selenium training in chennai
selenium online courses best selenium online training
selenium testing training
selenium classes

zuan said...

Thanks for sharing an informative blog keep rocking bring more details.I like the helpful info you provide in your articles. I’ll bookmark your weblog and check again here regularly. I am quite sure I will learn much new stuff right here! Good luck for the next!
Web Designing Training Institute in Chennai | web design training class in chennai | web designing course in chennai with placement
Mobile Application Development Courses in chennai
Data Science Training in Chennai | Data Science courses in Chennai
Professional packers and movers in chennai | PDY Packers | Household Goods Shifting
Web Designing Training Institute in Chennai | Web Designing courses in Chennai
Google ads services | Google Ads Management agency
Web Designing Course in Chennai | Web Designing Training in Chennai

Anurag Srivastava said...

These blog concepts are new and unique it is easy to understand compared to other blogs. Keep updating this blogs...Sarkari Jobs 2020 including SSC, Banking Jobs, Railway Jobs, UPSC/Civil Jobs are provided. Sarkari result adda has complete information about all Sarkari Job

James said...

Data Scientist: A data scientist is someone who deciphers huge amounts of data and extracts meaning to help an organization or company to improve its operations data science course syllabus