Installing Atlassian Tools for Integration with JIRA
The Atlassian development tools work together with JIRA to give your team a fast and guided software development process.
このページでは...
... provides a guide to help admins configure JIRA and the Atlassian tools, so they work together as advertised.
For your JIRA server...
... see our overview of how the Atlassian development tools work together when installed on your servers.
For JIRA Cloud...
... see our overview of how the Atlassian development tools work together when hosted in the cloud.
サポート対象バージョン
The matrix on this page shows the minimum application versions required to enable the integration features described on Integrating JIRA with Code Development Tools.
| Jira | FishEye / Crucible | Bamboo | GitHub Enterprise | Bitbucket | Bitbucket Server (formerly Stash) | GitHub | Features enabled |
|---|---|---|---|---|---|---|---|
| 6.1.x | N/A | N/A | N/A | 現行 | Stash 2.8.x | N/A | 開発パネル
|
| 6.2 以降 | 3.3 以上/3.3 以上 | 5.4 以降 | 11.10.290 以降 | 現行 | Stash 2.10+ | 現行 | 開発パネル
|
| 6.3.3 以上 または JIRA Cloud | 3.5.2 | N/A | 11.10.290 以降 | 現行 | Stash 3.2.0 | 現行 | ワークフロー トリガー |
管理者用の開発ツール設定
The Development Tools section on the project administration screen gives you an overview of the development tools that are connected to your JIRA instance, and of the users who can use the integrations between JIRA and those tools.
表示権限
The View Permission section lists the user groups that can see the Development panel in a JIRA issue. The Development panel displays the Create Branch link, as well as 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.
アプリケーション
The Applications section lists the development tools that are connected to JIRA, and so shows which applications can take advantage of these integration features.
- In Cloud, any applications that are part of your Cloud subscription are linked together automatically; you don't need to do anything to start using the development tool integration features.
- You can connect your JIRA Cloud to your own locally installed instances of the development tools, such as Bitbucket Server, FishEye or Crucible, by setting up an application link (see below).
- You can connect your JIRA Cloud, or your locally installed instance of JIRA, to Bitbucket, GitHub or GitHub Enterprise using the DVCS Connector in JIRA.
Click Development Tools in the left navigation bar to manage these settings.
連携を機能させる
In general:
JIRA users only need the "View Development Tools" project permission to be able to see the Development panel. By default, anonymous users (those who are not logged in) don't have this permission, and so do not see the panel.
- A developer simply needs to supply a JIRA issue key, as follows, for the JIRA issue to be automatically linked:
コミットメッセージに課題キーが含まれる場合、コミットは自動リンクされます。
ブランチ名に課題キーが含まれる場合、ブランチは自動的にリンクされます。
プルリクエストのタイトルや、ソースブランチ名に課題キーが含まれる場合、プルリクエストは自動的にリンクされます。
レビューのタイトルに課題キーが含まれる場合、またはレビューから 課題がリンクされている 場合、レビューは自動的にリンクされます。
Builds and deployments are linked automatically if a commit involved in the build has the issue key in its commit message.
JIRA must be connected with Bitbucket Server, FishEye, Crucible or Bamboo using a 2-way application link that has both 2-legged and 3-legged authentication enabled. See the Application Links section below.
- JIRA must be connected with Bitbucket, GitHub or GitHub Enterprise using the DVCS Connector in JIRA. See Use the JIRA DVCS Connector.
- When using the supported versions of JIRA and the other applications, the Development panel replaces the Source, Commits and Builds tabs, as well as the Deployment panel, in a JIRA 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 locations.
- The details dialogs, for example for commits, may display duplicates, although the number of unique items are reported at the top of the dialog and in the Devlopment panel summary. Duplicate commits, for example, can arise from having both Bitbucket Server and FishEye linked to JIRA, and FishEye in turn connected with Bitbucket Server, so that FishEye indexes, and reports Bitbucket Server commits.
- 開発ツールのサマリーデータを表示できるユーザーが、サマリーに貢献したすべての情報の詳細ダイアログ (ブランチ、コミット、プルリクエストなど) の閲覧権限を持っていない場合があります。これは、詳細ダイアログが、そのユーザーが接続しているアプリケーションで持っているアクセス権限を尊重しているためです。
- Note that if commits linked to the JIRA 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.
Bitbucket
The DVCS Connector plugin needs to be enabled and configured in JIRA before you'll see information from Bitbucket in the Development panel of a JIRA (or JIRA Agile) issue. See Use the Jira DVCS Connector Add-on for details. Remember that you won't see Bitbucket information in the Commits tab at the bottom of the JIRA View Issue screen any more.
Bamboo
開発パネルは、「JIRA 課題の表示」画面の「ビルド」タブと「展開」パネルに置き換わりました。
FishEye-Crucible
When FishEye and Crucible (versions 3.3 and later) are linked with JIRA, you'll see FishEye branches and commits, and Crucible reviews, summarized in the Development panel – click on the links to see details of those. You can start the creation of Crucible reviews from the Commits details dialog. Note that with FishEye and Crucible version 3.3 and later, you won't see the Commits and Reviews tabs anymore; however, if any older instances are connected to JIRA, those tabs will continue to be displayed. See Application links below.
Bitbucket Server
When Bitbucket Server (Stash 2.10 or later) is linked with JIRA, you won't see the Source tab at the bottom of the JIRA View Issue screen any more.
The following system plugins are required. These are bundled and enabled by default:
- Atlassian Navigation Links Plugin (com.atlassian.plugins.atlassian-nav-links-plugin)
- Bitbucket Server Dev Summary Plugin (com.atlassian.stash.stash-dev-summary-plugin).
See Application links below.
GitHub
JIRA 課題の「開発」パネルでブランチ、コミットおよびプルリクエスト情報を表示できるよう、JIRA で DVCS コネクタープラグインを設定できます。
アプリケーション リンク
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 an application to be included in the summaries in the Development panel; 3LO requires a user to authenticate with the other application in order to see information in any of the details dialogs.
- Users who can see summarized data in the Development panel may not have permission to see all the information that contributed to those summaries in the details dialogs (for example, for branches, commits and pull requests). That is, the details dialogs respect the access permissions that users have in the connected applications.
- An older application link between JIRA and any of those applications will need to have 2-legged authentication enabled.
