Redmine Trackmine Plugin
Redmine is an excellent multi-project issue tracking tool focussing on collaboration in the implementation and integration parts of software development. Pivotal Tracker, on the other hand, is a superb planning tool and extremely well suited for requirements capturing and customer feedback.
The Trackmine plugin provides simple but effective bi-directional communication between Pivotal Tracker and Redmine by outsourcing the workflow between Pivotal's “Started” and “Finished” states to Redmine. The triggers for teleporting between the tools are starting a story in Pivotal and closing an issue in Redmine. The workflow in Redmine remains customizable and can be tailored to individual needs. Step by step configuration tutorial
- UPGRADED to work with Pivotal Tracker API v5 and Redmine 3
Starting a story in a Pivotal Tracker automatically creates a Redmine issue with status “Accepted”.
Updating a story in a Pivotal Tracker updates the Redmine issue attributes (subject, description, status).
Closing a Redmine issue finishes the Pivotal Tracker story.
Mapping between Pivotal Tracker and Redmine attributes can be configured
In Redmine app run:
$ bin/plugin install https://github.com/capita/redmine_trackmine.git
or clone it into /vendor/plugins/
$ git clone email@example.com:capita/redmine_trackmine.git
$ bundle install
Run plugin migrations
$ rake redmine:plugins:migrate
Configuration- Redmine side
Make sure you have following custom fields for Redmine Issue:
'Pivotal Project ID' (field_format: int, Trackers: Bug, Support, Feature) .
'Pivotal Story ID' (field_format: int, Trackers: Bug, Support, Feature) .
And there is IssueStatus 'Accepted'
Add valid Pivotal Tracker credentials in [redmine_app]/config/trackmine.yml
[redmine_email]: email: [pivotal_tracker_email] password: [pivotal_tracker_password] super_user: # You can use an api token or email/password for the PT api. token: [pivotal_tracker_api_token] error_notification: recipient: [email_for_error_notifications] from: "[information to emails FROM field]"
firstname.lastname@example.org: token: 1234 email@example.com: email: firstname.lastname@example.org password: 2222 super_user: email: email@example.com password: 1234 error_notification: recipient: firstname.lastname@example.org from: "Trackmine Notifications <email@example.com>"
Users mentioned in trackmine.yml should have administration rights in redmine. The user named 'super_user' should have access to all Pivotal Tracker projects you want to map to. It might be the Pivotal Tracker admin. Its credentials are used to handle Pivotal Tracker hooks.
Configuration- Pivotal Tracker side
Add Web Hook Url pointing to your Redmine app. To do that:
On your project page choose 'Project -> Configure Integrations'
Find Activity Web Hook section
In 'Web Hook Url' put [redmine_app_url]/pivotal_activity.json
As a Redmine administrator go to 'Administration -> Trackmine' section.
Use link 'Add mapping'
Select Redmine project and Pivotal project (or label)
You can configure:
Mapping between Pivotal story estimation points and Redmine estimated_hours
1 point => 1 hour 2 points => 4 hours 3 points => 10 hours
Mapping between Pivotal story_types and Redmine trackers
'feature' => 'Feature' 'bug' => 'Bug' 'chore' => 'Support'
Trackmine has RSpec test coverage. Run specs with:
Copyright © 2010-2015 Capita Unternehmensberatung GmbH. See LICENSE for details.