Linking Git to Jira - An easy to use Guide

This video describes everything you need to know about linking a git commit to Jira

Getting Started

Assumptions

  • An administrator has installed one of Bitband’s Git products in your Jira Environment.

  • In settings, you have connected to at least one of your Git repositories and it is indexed. If you need help with this see: setup

Linking Git to a Jira Commit

Assume you have an existing Jira Issue like the one below. Take a note of the issue key as highlighted below:

Map the commit to Jira

Mapping is easy. Just include the Jira Key in the Commit. In the example below I map a specific commit to the Jira issue BW-32 $ git add docs/* $ git commit -m “BW-32 This is my commit message”

After you make this commit you can view code commit details within the Jira issue.

Smart Commits

Bitband’s Git tool also provides some powerful Smart Commits. They include:

  • Tracking Time

  • Assigning an Issue

  • Transitioning an Issue

Tracking Time

Use the #time command to record time against a Jira issue. Example:

$ git commit -m “BW-32 #time 1w:1d:2h Total work logged”

Assigning an Issue

Use the #assign command to assign a particular issue to a specified Jira user. Example of assigning an issue to a specific Jira user called jbailey.

$ git commit -m “BW-32 #assign jbailey”

Transitioning an Issue

Use the #transition command to move the Jira issue to a particular workflow state. For example to move the issue BW-32 to state “closed” use the following command.

$ git commit -m “BW-32 #transition closed”

In Summary

This tool provides a simple but powerful method for a developer to link details of their work to Jira and map to a specific issue. Onboarding your developers to this methodology is easy and all you need to do is provide them a link to this page to get started.