Integrating with development tools

Connecting Jira Software to compatible development tools provides your team with a range of functionality and information related to your development work. You can connect to multiple instances of the same development tool, but it's recommended you set up one of these instances as the primary link, meaning Jira Software will query that instance first when looking for that sort of information. For example, if you connect to Bitbucket Server instance A and Bitbucket Server instance B, and you make Bitbucket Server instance A the primary instance, when Jira Software needs info relating to Bitbucket Server it will query instance A.

Integration features

These are the features that become available when you connect Jira Software to the development tools listed below. We recommend that you use the latest version of each application – if you're using earlier versions, see the version matrix to find out which features are available.

On this page:



Development panel on issues

The Development panel is shown on the View Issue screen and provides the following functionality:

  • Bitbucket Cloud and Bitbucket Server: view and create branches, view commits, and view and create pull requests
  • Fisheye/Crucible: view commits and branches, view and create reviews
  • Bamboo: view the status of builds and deployments
  • GitHub and GitHub Enterprise: view commits, branches and pull requests

For more information about using the Development panel, see the Jira Software documentation.


The Development Panel

Workflow triggers

Workflow triggers can help keep Jira Software issues synchronized with the information in your development tools – Fisheye/Crucible, Bitbucket, and GitHub.

Instead of relying on developers to manually update the status of an issue after committing code, completing reviews, or creating branches, you can configure triggers in your workflow to automatically transition issues when these events occur in your development tools. For example, you could configure a trigger to automatically transition an issue from 'To Do' to 'In Progress' when a branch is created.

See Configuring workflow triggers for instructions on setting up workflow triggers.

There is a known issue where the 'Branch created' event isn't supported for GitHub, which is being tracked under DCON-432 - Getting issue details... STATUS — please keep this in mind when configuring trigger events.

 Workflow Triggers

Release Hub

The Release Hub shows the progress of a version, so you can determine which issues are likely to ship at a glance. The commits, builds, and deployments related to each issue are shown, helping you to spot potential development issues that could cause problems for a release.

When you are ready, you can also release the version from the Release Hub. Doing this marks the version as complete, moves incomplete issues to other versions, and triggers release builds (if Jira Software is integrated with Bamboo).

Read more about the Release Hub here:

Checking the progress of a version
 The Release Hub

How it works

When the Atlassian development tools are integrated with Jira Software, a user simply needs to supply an issue key for the issue to be automatically linked:

  • Commits are linked automatically if the issue key is included in the commit message.

  • Branches are linked automatically if the issue key is included in the branch name.

  • Pull requests are linked automatically if the issue key is included in the pull request's title or in the source branch name.

  • Reviews are linked automatically if the issue key is included in the title of the review, or if the issue is linked from the review.

  • Builds and deployments are linked automatically if a commit involved in the build has the issue key in its commit message. 

When triggers are configured in the workflow for your  project, particular events published by the developer tools automatically transition issues.

There are some details and known issues:

  • When a user attempts to access one of the details dialogs, for commits, reviews, builds or pull requests, Jira Software checks that they have the appropriate permissions to view the information in the dialog. It does this using the user authentication that is configured in the Application Link.
  • The details dialogs (ex: for commits) may display duplicates, although the number of unique items are reported at the top of the dialog and in the Development panel summary. Duplicate commits, for example, can arise from having both Bitbucket Server and Fisheye linked to Jira Software, and Fisheye in turn connected with Bitbucket Server, so that Fisheye indexes, and reports. commits.
  • Users who can see summarized data in the Development panel may not have permission to see in the details dialogs (for example, for branches, commits and pull requests) all the information that contributed to the summaries. That is, the details dialogs respect the access permissions that users have in the connected applications.
  • If commits linked to the issue are involved with a Bamboo build that fails, the first successful build that follows will be reported, even though the original commits are no longer involved with that build.
  • The Development panel replaces the Source, Commits and Builds tabs, as well as the Deployment panel, in an issue. So, for example, you won't see the Source tab, and commits in Bitbucket Server will be accessible from the Development panel. However, if a connected application is older than the supported version, information from that application will continue to be displayed in those tabs rather than in the Development panel.

Supported versions

The table below shows the minimum development tool version required for each integration feature in Jira Software.


JiraFisheye / CrucibleBambooBitbucket CloudBitbucket ServerGitHubGitHub EnterpriseIntegration feature

6.4+

or Jira Cloud

3.3+/3.3+5.4+CurrentBitbucket Server 4.0+ (Stash 2.10)Current11.10.290+

Release Hub:

  • View issues and development information (from Bamboo, Bitbucket, or Fisheye/Crucible) for a version.
  • See warnings that help you reconcile what is happening in development with JIRA data.
  • Release a version, manage scope between versions, and trigger release builds from one place in JIRA.
6.3.3+ or Jira Cloud3.5.2N/ACurrent

Bitbucket Server 4.0+

(Stash 3.2.0)

Current11.10.290+

Workflow triggers

  • Transition JIRA issues from within Bitbucket Server and Fisheye/Crucible
6.2+3.3+/3.3+5.4+Current

Bitbucket Server 4.0+

(Stash 2.10+)

Current11.10.290+

Development panel:

  • Bitbucket: create and view branches and pull requests from an issue, view commits
  • Fisheye/Crucible(Git/Subversion/Perforce/CVS): browse and search repos, view commits and branches, create and view reviews
  • Bamboo: view the status of builds and deployments from the related issues
6.1.+N/AN/ACurrent

Bitbucket Server 4.0+

(Stash 2.8.x)

N/AN/A

Development panel:

Development tools configuration for a project

The Development Tools section of the administration screen for a project gives you an overview of the development tools that are connected to your Jira Software instance, and of the users who can use the integrations between Jira and those tools. Users must have access to the Jira Software application to be able to see the Development panel. By default, anonymous users (those who are not logged in) and users without explicit Jira Software application access do not see the panel. 

View Permission

The View Permission section lists the user groups that can see the Development panel in a Jira Software issue. The Development panel displays the Create Branch link and summary information for your development process, such as the number and status of the related commits, pull requests, reviews and builds. The visibility of the panel is controlled by the "View Development Tools" project permission.

Applications

The Applications section lists the development tools that are integrated with Jira Software.


Set up Jira Software with development tools

Check that you have a compatible version of a development tool on the version matrix, then follow the instructions below to connect your code development tools to Jira.

Link to BitBucket Server, Bamboo, Fisheye or Crucible

Jira must be connected with Bitbucket Server, Bamboo, Fisheye or Crucible using application links.

Note that for Bitbucket Server, the following system plugins are required (these are bundled and enabled by default in Bitbucket Server):

  • Atlassian Navigation Links Plugin (com.atlassian.plugins.atlassian-nav-links-plugin) 
  • Bitbucket Server Dev Summary Plugin (bitbucket-jira-development-integration-plugin).

If your developer tools instances are running on the same machine as Jira Software Server, you'll need to ensure that the applications uses distinct web contexts. This avoids authentication and session issues with OAuth and application links. For example, if you were running Fisheye and Jira, you would change the default paths to:

http://localhost:8080/
https://localhost:8060/Fisheye (rather than http://localhost:8060/)

Instructions:

Troubleshooting

Jira Application Development panel displays error - Couldn't read data

Last modified on Dec 10, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.