Getting started is easy. Install our app, set up your repository and have your team start making commits referencing the Jira issues they are working from.
Visit the Jira Git Integration Atlassian Marketplace page. Select the “Get it now” button to begin the installation. Follow the prompts to complete the installation. This application supports installing repos from multiple different git service providers and your own self-hosted servers.
We also have a specific Git Jira Integration for each of the following Git services:
Connecting to your Git repository in Jira is simple. After you have installed the Git Integration for Jira Software you can navigate to our repository configuration page by selecting Apps -> Git Integrtaion for Jira Sotware form the top navigation in Jira.
The configure page allows you to connect to your GitHub, GitLab, Gitea, AWS CodeCommit, Azure DevOps, GitHub Organizations, Beanstalk, GitHub Enterprise, GitLab Enterprise, and Bitbucket repositories. Select the repository and authenticate your account. Connection with the Gitea, AWS CodeCommit, GitHub Organizations, Beanstalk, GitHub Enterprise, GitLab Enterprise, Self-Hosted Git is more difficult so see additional instructions.
Once a connection has been made you can view the connection details, refresh, or disconnect at any time. All repositories belonging to your account will appear as shown below. By default, they are turned off.
The connection can be turned on or off by the toggle button as shown turned on below.
The Action menu allows you to reindex and view logs for a repository.
For your convenience, you can view logs to see the indexing history of your git commits.
Click the “Action” icon nearby the enabled repository. If you select “Logs” the information list about logs will be opened.
But if you select “Clear logs” nothing will be shown but logs will be cleared. It could be checked by viewing the “Logs”.
Click the “Repo Explorer” icon nearby enabled repository.
You could see the information about all commits, branches and pull requests of selected repository.
In the configuration settings for each connected repository is the ability to define which Jira projects the repository is connected with. By default it's available in all projects. You my want to restrict the repo to be visible only in certain projects to limit user access to git and code information.
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.
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”
At this point you've conneted your git service, enabled your repos, and linked your first git commit to Jira. To dive into more capabilities of this app continue to read the Features section.