開発ツールとの連携

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.

連携機能

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:

 

 

動作の仕組み

アトラシアンの開発ツールが JIRA Software と統合されている場合、ユーザーが課題に対応する課題キーを入力するだけで、自動的にリンクが実行されます。

• コミットメッセージに課題キーが含まれる場合、コミットは自動リンクされます。

• ブランチ名に課題キーが含まれる場合、ブランチは自動的にリンクされます。

• プルリクエストのタイトルや、ソースブランチ名に課題キーが含まれる場合、プルリクエストは自動的にリンクされます。

• レビューのタイトルに課題キーが含まれる場合、またはレビューから 課題がリンクされている 場合、レビューは自動的にリンクされます。

• ビルドに含まれるコミットのコミット メッセージに課題キーが含まれる場合、ビルドとデプロイは自動的にリンクされます。 

トリガーがプロジェクトのワークフローで設定されている場合、開発者ツールによって発行された特定のイベントは、自動的に課題をトランジションします。

以下に、詳細と既知の問題をいくつか挙げます。

• ユーザーがコミットやレビュー、ビルド、プルリクエストの詳細ダイアログのいずれかにアクセスしようとすると、JIRA Software は、そのユーザーがダイアログの情報を表示する適切な権限を持っているか確認します。JIRA はアプリケーション リンクで設定されているユーザー認証を使用して、これを実行します。
• ダイアログの上部と開発パネルのサマリーに一意のアイテムの数が表示されますが、詳細ダイアログ（たとえば、コミットのダイアログ）では重複して表示される場合があります。たとえば、Bitbucket サーバーと FishEye の両方が JIRA Software にリンクされていて、同様に FishEye が Bitbucket サーバーに接続され、その結果、FishEye のインデックス、レポート、コミットに接続されている場合に、コミットの重複が生じます。
• 開発ツールのサマリーデータを表示できるユーザーが、サマリーに貢献したすべての情報の詳細ダイアログ (ブランチ、コミット、プルリクエストなど) の閲覧権限を持っていない場合があります。これは、詳細ダイアログが、そのユーザーが接続しているアプリケーションで持っているアクセス権限を尊重しているためです。
• 課題にリンクされたコミットが Bamboo の失敗ビルドに含まれている場合、後で成功したビルドに元のコミットが含まれていなくても、最初に成功したビルドが報告されます。
• 開発パネルは、課題のソース タブ、コミット タブ、ビルド タブ、デプロイメントパネルに置き換わっています。したがって、たとえば、ソース タブは表示されず、開発パネルから Bitbucket サーバーのコミットにアクセスします。ただし、接続されたアプリケーションがサポート対象バージョンより古い場合は、そのアプリケーションからの情報は開発パネルではなく、これらのタブに引き続き表示されます。

サポート対象バージョン

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

 

プロジェクト用の開発ツールの設定

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. 

表示権限

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.

アプリケーション

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

 

JIRA Software に開発ツールをセットアップする

バージョン マトリックス で、開発ツールの互換バージョンを持っていることを確認した後、 以下の説明にしたがってコード開発ツールを JIAR に接続します。

BitBucket Server、Bamboo、FishEye、Crucible へのリンク

JIRA はアプリケーション リンクを使用して、 Bitbucket サーバー、Bamboo、FishEye、Crucible に接続する必要があります。

Bitbucket サーバーの場合、以下のシステム プラグインが必要であることにご注意ください （これらのプラグインは Bitbucket サーバーに既定でバンドルされ、有効化されています）。

• Atlassian Navigation Links Plugin (com.atlassian.plugins.atlassian-nav-links-plugin) 
• Bitbucket サーバー開発サマリー プラグイン（bitbucket-jira-development-integration-plugin）。

トラブルシューティング

JIRA アプリケーション開発パネルにエラーが表示されます －データを読み取ることができませんでした