March 28th 1 PM ET

Git Integration for Jira Cloud Documentation

Web linking

OPTIONAL

The web linking feature adds links to your git hosting provider directly into the Git Commits tab. Configure web linking options while editing repository settings ( _Actions ➜ Edit integration | ActionsEdit repository) so that commits can include links to the git host pages.

The Git Integration for Jira Cloud app automatically configures web links for most git hosts via Git service integration panel.

For single git repository integration, web link setup is optional. However, git links will become available in Git Commits tab when configured.

Right click here to open this video in a new browser tab for more viewing options.

The following providers are supported:

  • cgit

  • Fisheye

  • GitHub

  • Gitorious

  • gitweb

  • Beanstalk

  • CloudForge

  • Atlassian Stash

  • GitLab

  • TFS (starting v2013)

  • Azure Server

  • VSTS

  • Azure DevOps

  • Gerrit

  • Bonobo

  • AWS CodeCommit

  • Bitbucket

  • Bitbucket Server

  • Gitblit

  • Gitolite

Select a git host from the Web Link list. The web linking format fields are automatically filled out with corresponding variables for the selected git host service. Change the variables according to the actual URL settings of the git host.

Only configure the variables enclosed in <> (tags) and leave variables enclosed in {} (brackets) as is.

You can create several custom configuration to support other git hosting providers. The following five URLs should be configured for setup:

Option Description
View Format String. Optional. 

This URL is unused and not being configured for the newly added integration types.

Changeset Format This is the URL used to display revision.
Use the following variable: ${rev}  – git revision
File Added Format,
File Modified Format,
File Deleted Format
This is the URL to display content of added, modified or deleted files. Use the following variables:

  • ${num} –  number of change (0, 1, …)
  • ${rev}  –  git revision
  • ${path}  –  path of the file being changed
  • ${parent}  –  parent git revision
  • ${blob}  –  ID of blob object
  • ${parent_blob}  –  ID of parent blob object
  • $convert(${branch},"subStr","newSubStr")  –  this inline function returns branch name with subStr replaced by a newSubStr. As of v2.11.0+ of the Git Integration app, the ${branch} code has been changed to cope up with the character requirements on some hosting services.
Branch Format This is the URL to display content of branches.
Tag Format This is the URL to display content for tag information.
The Git Integration for Jira app supports an unlimited number of repositories.

Some git hosts require web linking to be configured via the Git Integration app ➜ Actions ➜ Edit repository screen (mostly single git repository integrations).

The Bonobo git server requires a branch name to construct URL.  Use $convert(${branch},"/","~2") for web linking since bonobo requires substitution of / with ~2 in the branch name.

For example:
http:///Bonobo.Git.Server/Repository//$convert(${branch},"/","~2")/Commit/${rev}

Any git host that is accessible via SSH, HTTP, HTTPS and git protocol is supported.

Once properly configured, the Git Commits tab on the Jira Issues page will display as follows:

The Git integration app supports custom web linking. The commit information is displayed
in the Git Commits issue tab if the git host server URL is provided on the
Web Linking section when editing repository settings.

 


Prev: General settings for Administrators

Next: Linking git commits to Jira issues

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