« Table of Contents

Repository Browser Jira Server Only

Git for Jira Cloud only has Repository Browser: Compare feature. See below.

The Repository Browser allows users to view git repositories of configured projects via the Git menu on the Jira dashboard.  This feature is only available on Jira Server instances.

Git menu
As of v2.5+ of the Git Integration for Jira app, the Git dropdown menu is added to the dashboard.
Jira Permissions
Users must have the View Development Tools project permission in order to gain access to the Repository Browser. For more information on assigning Jira permissions, see Managing Permissions in Jira open in new tab.
Git menu
The Git menu header is hidden for all users if there are no repositories with Repository Browser enabled for that user.  The Git Integration for Jira app will always show the Git menu to Jira administrators.
The Git menu header is visible to other users who have repositories with Repository Browser enabled and have no history of using the Repository Browser (for example - no previously viewed or favorited repositores).
The Repository Browser will not display the repository if it is disabled in the Git Repositories configuration. The commits and code diffs in the Issue > Git Commits, Git Roll Up and Project tabs will also be unavailable due to this.

 

To view all repositories, select Git dropdown in the dashboard menu then View all repositories.

Jira Server/Data Center Jira Cloud

The View Repositories page is displayed.

Jira Server/Data Center Jira Cloud
git repo viewer screen - jira server/dc git repo viewer screen - jira cloud
Click on the image to view the large version.

Available git repositories of configured projects are displayed:

Jira Server Jira Cloud
  • Clicking Manage Repositories at the top right of the screen will open the Git Integration for Jira app repositories configuration page.
  • Under Personal access token column, click the   icon to open the Setup PAT dialog to add your user's personal access token (PAT) from the git integration.
  • Click a git repository to browse its contents.  This is the repository view for the selected repository.
  • In the repository view, clicking Repositories at the top right of the screen will return the display to the repositories list view.
  • In the repository view, select a branch from the dropdown list to browse repository contents for that branch (default view is master branch).
  • Click a folder to view its contents. Click a file to view its code diff.
  • Click on an issue link under Commit message to view that ticket.
  • Click on the commit id Latest commit: UUID link to view code diff for that commit.
  • Click on an item link under Latest commit column to view code diff for that particular commit.
  • The repository list displays twenty (20) repositories per page.  Click the page controls to view the rest of the repositories.
  • Clicking Manage Repositories at the top right of the screen will open the Git Integration for Jira app repositories configuration page.
  • Use the search box to look up for the repository that contains the text.
  • Use the page controls at the bottom right of the repository view panel to browse the repository list.
  • Click a git repository to view commits and commit associations.  This is the commits view for the selected repository.
  • In the repository view, clicking All repositories at the top right of the screen will return the display to the repositories list view.
  • In the commits view, select a branch from the dropdown list to browse repository contents for that branch (default view is master branch).
  • In the commits view, click the Change label to change the association of the commit to a Jira issue or set of Jira issues.
  • Use the Compare tab to perform comparisons of branches for the selected repository.  For more information, see below Comparing Branches/Tags in the Repository Browser
Since v2.6.0 of the Git Integration for Jira app, revisions of the commits are displayed on the Repository Browser in addition to branches and tags. See Repository Browser - Commits tab, for further information.
If the selected path is a root of the repository and no files are present, a message will be displayed instead of an empty file list.
Administrators can turn off the repository browser via advanced settings of a repository in the Git Integration for Jir app configuration.
The displayed repositories can be sorted by clicking the corresponding list header.  The Git Integration for Jira app will remember the sorting choice per user.
v3.6.x+  The view repositories page displays twenty (20) repositories per page.

Viewing List of Commits via Repository Browser

Jira Server/Data Center Jira Cloud

In the Repository Browser, click the Commits tab.

The list of commits for the currently selected project is displayed in decending order:

  • Select a branch from the dropdown list to browse commits for that branch (default view is master branch).  The branches and tags are sorted in reverse alphanumeric order putting the latest tags and branches at the top of the list.
  • Click on an issue link to view that ticket.
  • Click Change commit issues label to change commit associations of a Jira issue or set of Jira issues.
  • Click on a commit id commit ID to view commit information and code diffs related to that commit.

In the repository list, click a repository and the default view will be the Commits tab.

The list of commits for the currently selected project is displayed in decending order:

  • Select a branch from the dropdown list to browse commits for that branch (default view is master branch).  The branches and tags are sorted in reverse alphanumeric order putting the latest tags and branches at the top of the list.
  • Clicking on a user name will open the profile for that user.
  • Click on an issue link below the user name to view that ticket.
  • Click on the All, Linked and Unlinked filters to display only the commits for the selected filter.
  • On the columns to the right, click the Change label to change the commit association to a Jira issue or set of Jira issues (separated by commas).

Comparing Branches/Tags in the Repository Browser

Jira Server Data Center
On the Repository Browser (Jira dashboard > Git menu > View all repositories), click the Compare page tab.
Jira Cloud
On the repositories list view, click a repository name then click on the Compare tab.

On this page, two branches from the current repository can be compared.

A diff between the base branch and the compare branch is displayed:

To view desired results, use the following selection scenarios:

  • select master as base; select the most recent branch as compare.
  • select master as base; select a tag with a version release.
  • select different branches as base and compare. (Example: TYT-212 against TYT-316)

Click to swap the base and the compare selection.

The Summary page displays the Commits, Aggregated Lines by Developers and Files.  Click on a file to view its code diff.

Click Commits on the sidebar to view the list of commits resulting from this compare.  The adjacent figure indicates the number of commits associated to this compare.

Click Diff on the sidebar to view code diffs of the selected range of commits with the path and name of the affected files.

 

Jira Server/DC Introduced v2.10.0+
Click Issues on the sidebar to view list of unique Jira issues related to the commits.
On the Issues page (Compare tab), clicking the View all XX issues with JQL text label will open the Search page with passed query of a list of Jira issues found based from the compare criteria.
For example, the JQL will look like issuekey in (GIT-1851, GIT-1159, GITCL-284, GITCL-254).

Enable/Disable Repository Browser via Repository Configuration

Jira Server/DC Only

On your Jira dashboard, click Git > Manage (Git) repositories.

Click  cog  Actions > Edit  to modify required repository settings.  The Advanced setup screen for configuring repositories is displayed.

Scroll down to the Repository Browser option.

Select Enabled to activate this function for this repository. Choose Disabled to deactivate this function from this repository.

Add one or more existing projects in the Associate Project Permissions field to associate this git repository to the specified projects.  Administrators can view commit information via the commit ID URL link. For non-admin users from unspecified projects, the commit ID URL link will be inaccessible.

Checking the Associate with all projects box will hide the existing associated projects in the Associate Project Permissions field and disable it.  All existing associated projects in that field are still retained. When this setting is active, this git repository will be available to all existing projects in Jira.

Click Update to save configuration changes for this repository.

 

« Table of Contents