Integrating Rational Team Concert with Git

The IBM® Rational® Adapter for Git associates Git commits and Gerrit changes with Rational Team Concert™ work items. You create a link by annotating commit messages with a reference to a work item. When a push operation is made to a configured shared repository, the commit and the specified work item are linked. You can also use the Gitweb or Gerrit web interface to create links from Git commits or Gerrit changes to new or existing work items.
The Rational Adapter for Git supports various team and work flow configurations. For example, workflow for a site that uses Rational Team Concert for lifecycle management and Git as a source repository might be:

Rational Team Concert interface

In Rational Team Concert, links to Git commits are listed on the Links tab for a work item. The link name includes the commit summary and the SHA1:

Screen capture of work items page with defect and Link tab open. Link to Git commit is highlighted.

Git interface

Link information can be seen from Git in two ways. When you work from the command line, the link path is returned as part of the confirmation message for the commit:

Screen capture of link information as seen in a return message from a command line

For Gitweb interfaces, the adapter adds a section that is called Work Item Links. Click the twistie to open the Work Item Links section. Clicking Add Link opens the Create Link dialog. Current® links are shown, organized by Rational Team Concert project.

Screen capture of adapter installed work item menu for adding links from the Gitweb page

Gerrit interface

For Gerrit web interfaces, the adapter adds a section that is called Work Item Links. Click the twistie to open the Work Item Links section. Clicking Add Link opens the Create Link dialog. Current links are shown, organized by Rational Team Concert project.

Gerrit interface


Feedback