Recipe 1.9 Integrate GitHub with PivotalTracker
Problem
You wish to integrate a GitHub repository with PivotalTracker.
Solution
Go to the "My Profile" page of PivotalTracker, by selecting Profile form the dropdown.
Scroll down to the bottom of the and copy the API token, this will be needed later in this recipe.
Go to the Service Hooks page on GitHub for the repository that you want to send Tracker post-commit updates from and scroll down to Pivotal Tracker.
You now need to populate the Token field with the PivotalTracker API Token that was noted earlier on in this recipe. Leave the Branch field empty if it needs to listen on all branches, otherwise specify the branch(es). Leave the Endpoint field empty as we are using the cloud version of PivotalTracker.
Click the Add Service button.
Discussion
To ensure that the commits to GitHub are associated with the relevant work item add the below to all commit messages.
[#<Work item ID>] <Commit message>
e.g.
[#3128568] Refactor of the module