Using the Git adapter

The IBM® Rational® Adapter for Git associates Git commits with Rational Team Concert™ work items. You can continue working in Git, with the added ability to create a link between a Git commit and a Rational Team Concert work item. You create a link by annotating commit messages so that when a push operation is made to a configured shared repository, the commit and the work item specified in the annotation are linked.

The adapter uses Open Services for Lifecycle Collaboration (OSLC) to establish links between Rational Team Concert change requests and Git commits. Predefined link types are used.

You can link a commit to an existing defect in Rational Team Concert, or create a defect in Rational Team Concert and link to it from the adapter interface. You can work from the Git command line, Gitweb, the Gerrit command line, or the Gerrit web interface. These features give you the flexibility to work in a variety of team and work flow configurations. As an example, workflow for a site that uses Rational Team Concert for lifecycle management and Git as source repository might be:
  1. Open a defect in Rational Team Concert.
  2. Fix the defect.
  3. Commit your changes, adding adapter-supported syntax to the commit message to identify the Rational Team Concert defect you want to associate with the commit.
  4. Push the commit to your Git repository to create the link.
Alternatively, you could work exclusively from Git, using the adapter Work Item menu to find linked Rational Team Concert work items or to create new, linked work items in Rational Team Concert.

Feedback