Integrating JIRA with Code Development Tools
If you connect JIRA to a compatible development tool, JIRA will provide you with a range of functionality and information related to your development work.
Features
These are the features that you will enable, if you connect JIRA to the development tools listed below. We recommend that you use the latest version of each application. If you are not using the latest versions, see the version matrix to find out which features are available.
Development panel on issuesA Development panel is shown on the View Issue screen that provides the following functionality:
For more information about using the Development panel, see Streamlining your development with JIRA. |
|
Making it work
Check that you have a compatible version of a development tool on the version matrix, then follow the relevant instructions below to connect your code development tool to JIRA.
Connecting Bitbucket, GitHub or GitHub Enterprise to JIRA
Connections to Bitbucket, GitHub and GitHub Enterprise are done via the DVCS connector add-on that is bundled with JIRA.
- Follow the instructions on Linking Bitbucket Cloud and GitHub accounts to Jira Software to set up the connection.
Connecting Bitbucket Server, FishEye, Crucible or Bamboo to JIRA
Connections to Bitbucket Server, FishEye/Crucible and Bamboo use application links.
When you create a new application link between JIRA and an instance of Bitbucket Server, FishEye, Crucible or Bamboo, 2-legged (2LO) and 3-legged OAuth (3LO) are enabled by default. 2LO is required for information from any of those applications to be included in the summaries in the Development panel; 3LO checks that a user has authenticated with the other applications before they get to see the information in any of the details dialogs.
If you are upgrading from existing instances of JIRA, Bitbucket Server, FishEye, Crucible or Bamboo:
You may need to reconfigure the application link(s) between JIRA and the other applications. To enable the integration features, each application link must use 2-legged OAuth for both incoming and outgoing authentication.- Choose > Add-ons. Select Application Links in the left menu.
- Choose Edit for the application link.
- On the Outgoing Authentication tab, click OAuth. Ensure that Allow 2-legged OAuth is checked. Repeat for the Incoming Authentication tab. The application link update process will involve logging you into the other application for a short time to configure that end of the link, before returning you to JIRA.
Connecting other code development tools to JIRA
You can connect tools to JIRA, other than the ones listed on the version matrix. These tools do not enable the same integration features, but connecting them to JIRA does enable other functionality. See the pages below for instructions on how to connect these applications to JIRA and information about the functionality that is enabled.
- Integrating JIRA with FishEye (older versions, not on version matrix)
- Integrating JIRA with Bitbucket Server (older versions of Stash not on version matrix)
- Integrating JIRA with Bamboo (older versions, not on version matrix)
- Integrating JIRA with Subversion
- Integrating JIRA with Perforce
If your other applications are running on the same machine as JIRA (already installed), you need to ensure that the URL paths are different for the applications and JIRA. This will differentiate the applications and avoid authentication/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/)
This can be done for FishEye/Crucilbe as follows:
- Edit the
config.xml
in your FishEye/Crucible data directory. - Add the
context
attribute to theweb-server
element:
<web-server context="/fisheye">