Inform and Act

Read our official statements regarding recent executive orders and find resources to help you take action. Learn more

Continuous Integration is a fancy term for “run your project’s tests after someone pushes to the repository and notify interested parties if they fail.”

We’re currently in the process of revamping our test suite (which we’ll blog about in the future) and moving servers, so I thought it’d be a good time to re-evaluate our options.

Integrity has grown a lot since its first release. It has a ton of features, great documentation, and nice notifiers (I wrote the Campfire notifier).

It also has a very attractive interface, is easy to configure, and works with multiple projects. And it’ll run anything – not just Ruby projects.

It’s not the easiest thing to install, though. There are a lot of dependencies and I never quite got it working on my latest install attempt. I hear it works better with Passenger than Thin (what I was using).

If you can get it working, it’s worth it. qrush’s report card is a great addition, too.

BuildBot is a Python builder that’s pretty feature complete. And, of course, it works great with GitHub.

I installed it and tried it out – it’s pretty easy to use. And because it’s a generic builder you can also use it for non-test related tasks, like compiling stuff. It has a server BuildBot and worker BuildBots which means you can scale it to run many concurrent tasks, even across machines.

For us it seemed overpowered, but I’ll definitely keep it in mind if we need hardcore lifting in the future.

RunCodeRun is Relevance’s hosted CI service. It supports both private and open source projects, but is Ruby-specific.

For an example check out the AASM project overview or a specific build view. Pretty nice. It has tight GitHub integration, too, linking to each commit.

Unfortunately RCR doesn’t support Campfire notifications yet, as far as I can tell. We need ’em!

CI Joe

Because knowing is half the battle. CI Joe is a dead simple, Git-talkin’, Unix-lovin’, HTTP slingin’ continuous integration server we wrote to do one thing and do it well.

It uses your Git config and lets you extend it through Git hooks. A POST will trigger a build – which means it works great with GitHub. It supports HTTP auth so Internet prankster can’t trigger your builds. It comes with Campfire support. It’s language agnostic – as long as your test suite can be run from a Unix shell, CI Joe can handle it.

Check out the documentation for the complete tour.

We use the Campfire notifier (I sound like a broken record, don’t I) and Joe’s HTTP basic auth feature. Our config looks like this:

$ cat .git/config
  user =
  pass = secret
  subdomain = github
  room = The GitHub Dancy Party
  user = chris
  pass = secret
  runner = rake -s test:units

We also use Joe’s “after-reset” hook. We keep our database.yml file in Git, but the CI server needs its own database config settings. If Joe finds an executable “after-reset” Git hook it’ll run it after updating the repo and before running the tests. Ours looks like this:

$ cat .git/hooks/after-reset
rm config/database.yml
cp database.yml config/database.yml

As you can see, we keep our good database.yml unversioned in the CI clone’s root and just remove the versioned one after each reset. Joe runs a “git reset —hard” which does not remove unversioned files – our custom database.yml won’t get wiped.

Again, check out the source and documentation to get rollin’. Issues go to Issues or the mailing list.


Have feedback on this post? Let @github know on Twitter.

Need help or found a bug? Contact us.