開発ツールとの連携

JIRA Software を互換性のある開発ツールと連携させることにより、チームの開発業務に関連するさまざまな機能や情報を利用できます。同じ開発ツールの複数のインスタンスへ接続できますが、これらのインスタンスのうち 1 つをプライマリ リンク (JIRA Software がその種類の情報を探すときに最初にそのインスタンスにクエリする) として設定することをお勧めします。たとえば、Bitbucket Server インスタンス A と Bitbucket Server インスタンス B を接続し、Bitbucket Server インスタンス A をプライマリ インスタンスにすると、JIRA Software で Bitbucket Server に関する情報が必要となったとき、最初にインスタンス A をクエリします。

連携機能

JIRA Software を以下に挙げられている開発ツールに接続すると使用可能になる機能は次のとおりです。各アプリケーションの最新バージョンを使用することをお勧めします。 最新バージョンを使用していない場合、 バージョンマトリックスを参照して、利用可能な機能を確認してください。

On this page:

 

 

課題の開発パネル

開発パネルは、課題の表示画面に表示され、次の機能を提供します。

  • BitbucketまたはBitbucket Server:ブランチの表示と作成、コミットの表示、プルリクエストの表示と作成
  • FishEye/Crucible:コミットの表示、ブランチの表示、レビューの表示と作成
  • Bamboo:ビルドとデプロイのステータスを表示する
  • GitHub または GitHub Enterprise: コミット、ブランチ、およびプルリクエストの表示

開発パネルの使用方法の詳細については、JIRAソフトウェアのドキュメントを参照してください。

 

開発パネル

ワークフロー トリガー

ワークフロートリガーは、JIRA 課題を開発ツール (FishEye/Crucible、Bitbucket、GitHub) 内の情報と常に同期させておくのに役立ちます。

コードのコミット、レビューの完了、またはブランチの作成後に課題のステータスを手動で更新することを開発者に任せる代わりに、開発ツールでこれらのイベントが生じたら、自動的に課題をトランジションするようワークフローにトリガーを設定することができます。たとえば、ブランチが作成されたら課題を「To Do」から「進行中」に自動的にトランジションするようにトリガーを設定することもできます。

ワークフロートリガーの設定に関する説明は、ワークフロートリガーの設定を参照してください。

「ブランチ作成」イベントが GitHub でサポートされないという既知の問題があります。この問題は、DCON-432 - 課題詳細を取得中... ステータスで追跡されています。トリガー イベントを設定する際は、この問題にご注意ください。

 ワークフロートリガー

リリース ハブ

リリースハブは、バージョンの進捗状況を示すので一目でリリースされそうな課題を判別できます。各課題に関連するコミット、ビルド、およびデプロイメントが表示され、 リリースに向けて問題が生じそうな開発課題を識別するのに役立ちます。

リリースの準備が整っている場合は、リリース ハブからバージョンをリリースすることも可能です。これにより、バージョンを完了としてマークし、未完了の課題を他のバージョンに移動し、リリース ビルドをトリガーします( JIRA Software が Bamboo に接続されている場合)。

リリース ハブの詳細を読む

バージョンの進捗確認
 リリースハブ

動作の仕組み

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

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

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

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

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

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

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

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

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

サポート対象バージョン

以下の表は、 JIRA Software で各統合機能を利用するのに必要な、開発ツールの最低限のバージョンを示しています 。

 

JiraFishEye / CrucibleBambooBitbucket CloudBitbucket ServerGitHubGitHub Enterprise連携機能

6.4 以降

または JIRA Cloud

3.3 以上/3.3 以上5.4 以降現行Bitbucket Server 4.0 以上(Stash 2.10)現行11.10.290 以降

リリース ハブ

  • (Bamboo、Bitbucket、または FishEye/Crucible からの)バージョンの課題と開発情報を表示する。
  • 開発で起こっていることと JIRA データとを照合するのに役立つ警告を表示する。
  • JIRA の 1 つの場所から、バージョンのリリース、バージョン間のスコープ管理、リリース ビルドのトリガーを行う。
6.3.3 以上 または JIRA Cloud3.5.2N/A現行

Bitbucket Server 4.0 以上

(Stash 3.2.0)

現行11.10.290 以降

ワークフロー トリガー

  • Bitbucket Server および FishEye/Crucible 内から JIRA 課題をトランジションさせる
6.2 以降3.3 以上/3.3 以上5.4 以降現行

Bitbucket Server 4.0 以上

(Stash 2.10 以上)

現行11.10.290 以降

開発パネル

  • Bitbucket:課題やビュー コミットからブランチやプル リクエストを作成、表示する
  • FishEye/Crucible(Git/Subversion/Perforce/CVS):レポートの参照と検索、コミットおよびブランチの表示、レビューの作成と表示を行う。
  • Bamboo:ビルドと開発のステータスを表示する
6.1. 以上N/AN/A現行

Bitbucket Server 4.0 以上

(Stash 2.8. 以上)

N/AN/A

開発パネル

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

プロジェクト管理画面の開発ツール セクションには、 JIRA Software インスタンスに接続された開発ツールの概要と、 JIRA とツールの統合を利用できるユーザーに関する概要が記載されています。ユーザーが開発パネルを表示するには、 JIRA Software アプリケーションに対するアクセス権限が必要です。既定では、匿名ユーザー(ログインしていない人)および JIRA Software アプリケーションに対する明示的なアクセス権限を持っていないユーザーは、パネルを表示できません。 

表示権限

表示権限セクションでは、 JIRA Software 課題で開発パネルを表示できるユーザー グループを一覧表示しています。開発パネルには、ブランチ作成リンクが表示されるとともに、関連するコミット、プルリクエスト、レビュー、ビルドの数やステータスなど、開発プロセスのサマリー情報が表示されます。パネルの表示方法は、"開発ツールの表示" プロジェクト権限によって制御されます。

アプリケーション

アプリケーション セクションでは、 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 Software サーバーと同じマシン上で稼働している場合、 そのアプリケーショが異なるウェブ コンテキストを使用していることを確認してください。 これにより OAuth とアプリケーションリンクに関わる認証およびセッションの問題を回避できます。たとえば、 FishEye と JIRA を稼働していた場合、既定のパスを次のように変更します。

http://localhost:8080/
https://localhost:8060/fisheye ( http://localhost:8060/ ではありません)

手順説明

トラブルシューティング

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

最終更新日: 2018 年 2 月 12 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.