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 apply to your applications/versions.
Development panel on issuesA Development panel is shown on the View Issue screen that provides the following functionality:
For more information on how to use the Development panel, see Viewing the Code Development Information for an Issue. |
|
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 Stash, FishEye/Crucible or Bamboo to JIRA
Connections to Stash, FishEye/Crucible and Bamboo are done via application links.
If you are installing new instances of JIRA, Stash, FishEye/Crucible and Bamboo:
Application links are automatically set up when you install the applications. Just make sure that you install JIRA first, then enter the JIRA details when setting up the other applications.- When a user accesses the details dialog, JIRA will verify they have the appropriate permissions to view items in the dialog before it renders that information. For example, commits, reviews, builds and/or pull requests. It does this using the user authentication that is configured in the Application Link.
If you are upgrading from existing instances of JIRA, Stash, FECRU, 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 (without user impersonation) 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.
- Choose
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 Stash (older versions, 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.xmlin your FishEye/Crucible data directory. - Add the
contextattribute to theweb-serverelement:
<web-server context="/fisheye">