Integrating Pivotal Tracker and GitHub

I’ve been a Pivotal Tracker user for some time now and I’ve recently moved my code to GitHub, so I was interested when I found John Metta’s article which talks about automatically updating the progress of PT stories using a post-commit hook.

To get it set up you need to:

  1. Get an API token from Pivotal Tracker
    1. Scroll to the ‘API TOKEN’ section at the bottom of your profile page.
    2. If you don’t already have a token, click the ‘Create New Token’ button.
  2. Add the token to the service hooks on the GitHub repository
    1. Click on the settings tab for the repository
    2. Go to the Service Hooks section
    3. Scroll down the list of available service hooks and click on PivotalTracker
    4. Paste in your token
    5. Click ‘Update settings’

Now you’re ready to update your stories by including the special syntax in the commit message, specifying the story ID and (optionally) an action:
[fixes|completes|finishes|delivers #123456] My commit message
(Pivotal Tracker API Help Page)

About Jennifer Phillips Campbell

Software Developer and Medieval Historian
This entry was posted in Version Control. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s