gitlab-org--gitlab-foss/doc/user/project/integrations/pivotal_tracker.md

1.6 KiB

stage group info
Ecosystem Integrations To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Pivotal Tracker service (FREE)

This service adds commit messages as comments to Pivotal Tracker stories.

Once enabled, commit messages are checked for square brackets containing a hash mark followed by the story ID (for example, [#555]). Every story ID found gets the commit comment added to it.

You can also close a story with a message containing: fix [#555]. You can use any of these words:

  • fix
  • fixed
  • fixes
  • complete
  • completes
  • completed
  • finish
  • finished
  • finishes
  • delivers

Read more about the Source Commits endpoint in the Pivotal Tracker API documentation.

See also the Pivotal Tracker integration API documentation.

Set up Pivotal Tracker

In Pivotal Tracker, create an API token.

Complete these steps in GitLab:

  1. Go to the project you want to configure.
  2. Go to the Integrations page.
  3. Select Pivotal Tracker.
  4. Ensure that the Active toggle is enabled.
  5. Paste the token you generated in Pivotal Tracker.
  6. Optional. To restrict this setting to specific branches, list them in the Restrict to branch field, separated with commas.
  7. Select Save changes or optionally select Test settings.