JenkinsTracker

jenkins_tracker is a command line utility packaged as a RubyGem that integrates Jenkins CI build information with Pivotal Tracker stories within a project.

This is an example of a successful build integration:

Requirements

Jenkins

• Git as your SCM via the Jenkins Git Plugin.

• The build changelog file is available at $JENKINS_HOME/jobs/$JOB_NAME/builds/$BUILD_NUMBER/changelog.xml. The changelog contents look like this example.

• Ruby is available in the environment.

• Environment variables exists for $JENKINS_HOME, $JOB_NAME, $BUILD_NUMBER & $BUILD_URL.

Pivotal Tracker

• You have created an API Token.

• Project has API access enabled (it's enabled by default).

Installation

Add this line to your application's Gemfile:

gem 'jenkins_tracker'

And then execute:

$ bundle

Or install it yourself as:

$ gem install jenkins_tracker

Usage

As a Post-build Action script

Requires the Post build task plugin:

# Assuming environment variables for $JENKINS_HOME, $JOB_NAME, $BUILD_NUMBER & $BUILD_URL exists

$ bundle exec jenkins_tracker integrate --tracker-token ABC123456 --tracker-project-id 123456
# => Successfully integrated Jenkins Job $JOB_NAME with Pivotal Tracker Project #123456

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request