The JIRA Git Integration is designed to show a developers git commits within JIRA for more efficient project management and tracking. It is designed to allow a project manager to quickly and easily see what work is done in and by whom on any JIRA issue. The app searches your Git repository and indexes commit comments to JIRA issues. This app supports connections to GitHub, GitLab and Bitbucket repositories.
You can find this app on the Atlassian Marketplace here: https://marketplace.atlassian.com/plugins/jiragitintegration/cloud/overview
Getting Started - Overview
Getting started is easy. Install our app, setup your repository and have your team start making commits referencing the JIRA issues they are working from.
App Install via Atlassian Marketplace
Visit the JIRA Git Integration Atlassian Marketplace page. Select the “Get it now” button to begin installation. Follow the prompts to complete installation.
Setup Your Repository
Connecting to your Git repository in JIRA is simple. After you have installed the JIRA Git Integration app you can navigate to our repository configuration page by the following steps:
Choose -> System
Advanced -> JIRA git integration
Fill in the Jira config setting to set up the correct work of the commands that the commit messages will include.
Email - a valid user, who will send the command throught the commit messages
Api token - an unique token created in the Manage Account settings in Jira
The configure page allows you to connect to your GitHub, GitLab and Bitbucket repository. Select the repository and authenticate your account.
Once a connection has been made you can view the connection details, refresh or disconnect at any time. All repositories belonging to your account are shown below. By default they are turned off as shown below.
Connection can be turned on or off by the toggle button as shown turned on below.
The Action menu allows you to reindex or unindex a repository.
Linking Git commits to your JIRA Issue
Linking your Git commits to a JIRA issue is super easy. When a developers commits their code all they need to do is reference the issue they are working on.
Commit Comment Example (For a JIRA project with an issue labeled SB-3)
Example: Added login feature as described in SB-3
Viewing Commits in JIRA
Git commits are available for a project and for a specific issue.
Viewing Project Commits
To view a Project Commit navigate to the project our repository configuration page by the following steps:
Choose -> Project -> JIRA Git Integration
All commits related to this project are shown here.
Viewing Issue Commits
To view an Issue Commit navigate to the JIRA issue and click on the Git tab located as shown below.
Clicking on Git will display all the commits created for a specific issue. This example shows the bottom of the page for JIRA issue SB-3, showing all the commits with SB-3 in the commit comment.
The commands allow you to comment, assign, transition Jira issues and add a worklog to them via Gitlab,Github, Bitbucket commits.
The #comment command allows adding the comment to Jira issue. You must add the command to the commit message in the following format:
Example, QWER -1 #comment Please give more detail information
The #transition command allows changing workflow state of the issue. If the transition state is not valid or the user does not have access to make this change then the transition will not work. You must add the command to the commit message in the following format:
<Issuekey> #<transition-name> <Your comment text>
The #assign command allows assigning the particular issue to the specified Jira user. You must add the command to the commit message in the following format:
<Issuekey> #<assign> <Jira username>