Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Contact Support
GitKraken Status  

Git Integration for Jira Data Center/Server – Release Notes

We publish new features, bug fixes, security updates/patches, and Jira compatibility regularly. Below are highlights of the changes.

Important links

If you have any questions, please contact us through our Support Portal or by emailing [email protected]


Manager Permissions

05 Feb 2024 NEW FEATURE ADMINS

Jira Admins can now share app management control (e.g. change settings, update integrations) with other trusted users. In the past, Jira Admins were the only users that could setup integrations and otherwise manage the app. With the new Manager Permissions page, Jira Admins can use Global Permissions and Groups to allow other Jira users to perform the actions that were previously limited to admins. View the help article for more information.

GitLens for Visual Studio Code Integration

29 Mar 2023 NEW FEATURE ALL USERS

This workflow improvement is a great addition for developers that are using Visual Studio Code to edit source code. GitLens is a Visual Studio Code extension that helps users visualize code, explore Git repositories, use powerful compare commands and so much more. From within Jira, clicking on the GitLens icon next to repositories, commits, tags, and branches will open them in VS Code.


This enables team members to quickly transition between Jira and their code editor without losing context. GitLens deep links are located within Jira issues and the Repository Browser. View the help article for more information.

Indexing Queue Viewer

26 Jan 2023 NEW FEATURE ADMINS

The Indexing queue viewer allows you to easily view upcoming and in-progress tasks such as repository indexing and garbage collection.
This provides greater visibility into what’s happening with your repositories and system resources.


This view displays detailed information about the tasks – which node it was processed on, start time, finish time, processing time, task id, and more.
Easily see which tasks are in the queue, find specific tasks by history, and filter tasks by specific parameters. View the help article to learn more.

Dedicated indexing nodes for Jira Data Center

22 Mar 2022 NEW FEATURE ADMINS

New General setting for specifying specific DC nodes to perform Git Integration for Jira indexing jobs.


Added support for SSH config file

14 Mar 2022 NEW FEATURE ADMINS

Support for the SSH Config File was implemented when connecting repositories via SSH.

Enforce GitHub permissions to view Git data

01 Mar 2022 NEW FEATURE ADMINS

  • Jira administrators can require Jira users to provide a GitHub personal access token to verify repository permission to view all development information provided by the Git Integration for Jira app.

  • When enabled, GitHub permissions are required to see: Repositories, Commits, Branches, Pull Requests and Tags.

  • Limited to GitHub.com and GitHub Enterprise Server git services. Support for GitLab and Azure DevOps available at a later date.

Data Center indexing job improvements

09 Dec 2021 NEW FEATURE INDEXING

  • Queue shared between all Data Center nodes.

  • Each node has a separate indexing job thread for faster indexing times.

Repository indexing skipping

09 Dec 2021 NEW FEATURE ADMINS

  • Skipping — Duplicate indexing tasks on the same repositories are not added to the queue.

Webhook indexing sleep setting

09 Dec 2021 NEW FEATURE ADMINS WEBHOOK SETTING

  • Sleep — Prevents repositories’ indexing tasks from being added too often. (5)

View all repositories renamed to Repository browser

09 Dec 2021 IMPROVEMENT ALL USERS

View all repositories has been renamed to Repository browser for consistency.

${basebranch} Branch name template

09 Dec 2021 NEW FEATURE ADMINS GENERAL SETTINGS

We have added the ${basebranch} variable to the Branch name template in General settings.

Deep Linking to GitKraken

21 Sep 2021 NEW FEATURE ALL USERS

With the acquisition of BigBrassBand’s Git Integration for Jira app (GIJ) by GitKraken, we have introduced deep linking between GIJ and GitKraken so users can now have a stronger integration between the two. You can now click to open commits, branches, tags and repositories directly in GitKraken from the Jira issue view giving you a seamless transition from your Jira issues to GitKraken.

Learn more

You will see the added ability to open the GitKraken client from our app in various locations. See an example of what this looks like below.


Native Jira audit logging support

26 Mar 2021 NEW FEATURE GENERAL SETTINGS

With the auditing feature, key activities are tracked on the Jira instance. This provides administrators insight on how the instance is being used.


The audit log functionality is also extended to Jira Data Center instances as it will have more coverage areas, various event volume levels and an option to integrate the audit log file with external tools.

For more information on this feature, see General settings – Audit log settings.

Automatically add link to Jira issue in PRs/MRs created in a Jira issue

26 Mar 2021 NEW FEATURE



Pull/merge requests created via the git integration developer panel in the Jira issue will automatically add a link to the Jira issue where it was created from.

Add JMESPath support for Gerrit integration

26 Mar 2021 NEW FEATURE


Gerrit auto-connect integration now supports JMESPath. This feature is used to filter and limit which repositories are integrated.

Add JMESPath support for tracked folders

04 Dec 2020 NEW FEATURE ALL USERS

Tracked folder integration now supports JMESpath. This feature is used to filter and limit which repositories are integrated. For more information, read about JMESPath expressions on their website.


Follow this feature in this article.


Associate Pull/Merge requests to issues based on commits

27 Nov 2020 NEW FEATURE ALL USERS

A new setting has been added in General Settings that allows for pull request (PR) and merge request (MR) indexing via API. In earlier versions, automatic indexing of PR/MRs could not be avoided for auto-connect integrations. With this implementation, administrators can enable/disable this feature as a setting.

Additionally, the PR/MR will still be linked to the Jira issue even if users didn’t mention a Jira issue key in the PR/MR title or description – as long as it’s mentioned in a commit message.

The following settings are implemented in the Manage git repositories page ➜ General settings under Git pull/merge requests.


For more information, follow this article.


Add support for new AWS CodeCommit region: Europe (Milan)

09 Oct 2020 ALL USERS

Europe (Milan) has been added to the supported region list in the AWS CodeCommit integration.



Reimplement pull/merge request indexing

17 Sep 2020 IMPROVEMENT ALL USERS

This is an improvement of the feature which requires a full reindex after upgrading the app to switch over to the new PR handling.


Introduced cron style scheduling option for some General settings

17 Sep 2020 NEW FEATURE ADMINS

By scheduling jobs in Git Integration for Jira for Server and Data Center (in the General settings page) Jira administrators gain control over when jobs run.

Scheduled jobs showing repository indexing and gc

For detailed information, see this article,


Deduplicate webhook indexing triggers

17 Sep 2020 ALL USERS

This is an optimization feature where the new reindex request is skipped whenever there’s a similar occurrence in the queue. This process does not involve repositories that are currently being indexed.

DATA CENTER This implementation requires cluster lock usage to enforce synchronization between threads (webhook, manual, and scheduled reindex) and between nodes.


Automatically import repos from Gerrit

19 May 2020 NEW FEATURE ALL USERS

Gerrit integration has been added to the Auto-connect integration panel. Access this feature via the dashboard menu GitManage repositories.


Follow this feature in the Gerrit integration guide.


Extend Commits API to show branch name

19 May 2020 ALL USERS

The Commits REST API has been extended to show branch name in the results.


For more information, see Commits REST API.


Branch and PR/MR creation improvements

19 May 2020 NEW FEATURE ALL USERS IMPROVEMENT

Branch creation

  • Improved message matching in how Jira displays it.

  • Added clickable link to respective git hosts in the message which opens in a new tab/window.


Branch deletion

  • Improved message matching in how Jira displays it.


Pull/merge request creation

  • Automatically selects the first branch that has the Jira issue key in the branch title from the Source branch list.

  • Improved message matching in how Jira displays it.


For related information, see Creating Pull/Merge Request.


Support for Azure Files as storage for Jira Data Center

03 Mar 2020 NEW FEATURE ALL USERS

Git Integration for Jira app VERSION 3.5+ now supports Azure Files as storage for Jira Data Center.


Support Azure DevOps/VSTS/TFS webhooks

03 Mar 2020 NEW FEATURE ALL USERS

Git Integration for Jira app VERSION 3.5+ now supports webhooks for Azure DevOps/VSTS/TFS instances.

For more information, read Adding Webhooks for Azure DevOps/VSTS and Adding Webhooks for Azure DevOps Server/TFS in Confluence.


REST API to manage integrations

03 Mar 2020 NEW FEATURE ALL USERS

The REST APIs for the following articles were updated with refspec support:

See also Fetch Refspec with Auto-Connect Integration wizard in Advanced options:


The refspec options are available for supported auto-connect integrations via the Git Integration configuration page:



Added support for new AWS CodeCommit region: Asia Pacific (Hong Kong)

03 Mar 2020 ALL USERS

Asia Pacific (Hong Kong) has been added to the supported region list in the AWS CodeCommit integration.



New Smart Commit command: Label

03 Mar 2020 NEW FEATURE ALL USERS

The new smart commit #label adds a new label to a Jira issue. The label(s) are added to all mentioned Jira issues where more than one Jira issue key is referenced. Several labels can be created by introducing spaces between words for each label.

Syntax:

ISSUE_KEY #label [label1] .. [labelN]

Example 1 Example 2
ABC-123 #label bucketbreakfix bucketenhancement ABC-123 #label this-is-a-label
Result Result
Creates two (2) labels bucketbreakfix and bucketenhancement to the ABC-123 Jira issue. Creates the label this-is-a-label to the ABC-123 Jira issue.

Screens for Example 1

Show last three and first tag in sidebar

03 Mar 2020 NEW FEATURE ALL USERS

The Git Integration for Jira app will show the last three and first tags if no filter is set. If the filter is set, the Git for Jira app will use it and will display the tags sorted in ascending order by date.

If there are several git tags listed, click the more… label link to expand the list in increments of five tags.



Add safeguard to Smart Commits processing

07 Feb 2020 NEW FEATURE ALL USERS

Adds Max. commit age setting to General Settings which:

  • Sets a limit (in days) for Smart Commit processing.

  • Commits older than the Max commit age can be associated with the Jira issue but any Smart Commit commands will not be processed.

  • Protects against cases where old commits are merged into a new repository.


Have feedback about this article? Did we miss something? Let us know!
On this page