開発ツールとの連携
課題の開発パネル開発パネルは、課題の表示画面に表示され、次の機能を提供します。
For more information about using the Development panel, see the Jira Software documentation. |
|
ワークフロー トリガーWorkflow triggers can help keep Jira Software issues synchronized with the information in your development tools – Fisheye/Crucible, Bitbucket, and GitHub. コードのコミット、レビューの完了、またはブランチの作成後に課題のステータスを手動で更新することを開発者に任せる代わりに、開発ツールでこれらのイベントが生じたら、自動的に課題をトランジションするようワークフローにトリガーを設定することができます。たとえば、ブランチが作成されたら課題を「To Do」から「進行中」に自動的にトランジションするようにトリガーを設定することもできます。 ワークフロートリガーの設定に関する説明は、ワークフロートリガーの設定を参照してください。 「ブランチ作成」イベントが GitHub でサポートされない既知の問題があります。この問題は、DCON-432 - 課題情報を取得中... ステータスで追跡されています。トリガー イベントを設定する際は、この問題にご注意ください。 |  |
リリース ハブリリースハブは、バージョンの進捗状況を示すので一目でリリースされそうな課題を判別できます。各課題に関連するコミット、ビルド、およびデプロイメントが表示され、 リリースに向けて問題が生じそうな開発課題を識別するのに役立ちます。 When you are ready, you can also release the version from the Release Hub. Doing this marks the version as complete, moves incomplete issues to other versions, and triggers release builds (if Jira Software is integrated with Bamboo). リリース ハブの詳細を読む バージョンの進捗確認 |  |
動作の仕組み
アトラシアンの開発ツールが Jira Software に連携されている場合、ユーザーが課題に対応する課題キーを入力すると、課題が自動的にリンクされます。
コミットメッセージに課題キーが含まれる場合、コミットは自動リンクされます。
ブランチ名に課題キーが含まれる場合、ブランチは自動的にリンクされます。
プルリクエストのタイトルや、ソースブランチ名に課題キーが含まれる場合、プルリクエストは自動的にリンクされます。
レビューのタイトルに課題キーが含まれる場合、またはレビューから 課題がリンクされている 場合、レビューは自動的にリンクされます。
ビルドに含まれるコミットのコミット メッセージに課題キーが含まれる場合、ビルドとデプロイは自動的にリンクされます。
トリガーがプロジェクトのワークフローで設定されている場合、開発者ツールによって発行された特定のイベントは、自動的に課題をトランジションします。
以下に、詳細と既知の問題をいくつか挙げます。
- ユーザーがコミットやレビュー、ビルド、プル リクエストのために詳細ダイアログにアクセスしようとすると、Jira Software は、そのユーザーがダイアログの情報を表示する適切な権限を持っているか確認します。Jira はアプリケーション リンクで設定されているユーザー認証を使用して、これを実行します。
- 詳細ダイアログの上部と開発パネルのサマリーに一意のアイテム数が表示されますが、詳細ダイアログ (コミットのダイアログなど) では重複して表示される場合があります。たとえば、Bitbucket Server と Fisheye の両方が Jira Software にリンクされていて、同様に Fisheye が Bitbucket Server に接続され、Fisheye のインデックス、レポート、コミットで重複が生じます。
- 開発ツールのサマリーデータを表示できるユーザーが、サマリーに貢献したすべての情報の詳細ダイアログ (ブランチ、コミット、プルリクエストなど) の閲覧権限を持っていない場合があります。これは、詳細ダイアログが、そのユーザーが接続しているアプリケーションで持っているアクセス権限を尊重しているためです。
- 課題にリンクされたコミットが Bamboo の失敗ビルドに含まれている場合、後で成功したビルドに元のコミットが含まれていなくても、最初に成功したビルドが報告されます。
- 開発パネルは、課題のソース タブ、コミット タブ、ビルド タブ、デプロイメントパネルに置き換わっています。したがって、たとえば、ソース タブは表示されず、開発パネルから Bitbucket サーバーのコミットにアクセスします。ただし、接続されたアプリケーションがサポート対象バージョンより古い場合は、そのアプリケーションからの情報は開発パネルではなく、これらのタブに引き続き表示されます。
サポート対象バージョン
The table below shows the minimum development tool version required for each integration feature in Jira Software.
| Jira | FishEye / Crucible | Bamboo | Bitbucket Cloud | Bitbucket Server | GitHub | GitHub Enterprise | 連携機能 |
|---|---|---|---|---|---|---|---|
| 8.14 以降 | 3.3 以上/3.3 以上 | 5.4 以降 | 現行 | Bitbucket Server 4.0 以上（Stash 2.10） | 13.0 以降 | 13.0 以降 | GitLab/GitLab Self-Managed: ブランチ、コミットを表示し、リクエストをプルします |
6.4 以降 または Jira Cloud | 3.3 以上/3.3 以上 | 5.4 以降 | 現行 | Bitbucket Server 4.0 以上（Stash 2.10） | 現行 | 11.10.290 以降 | リリース ハブ
|
| 6.3.3 以上 または Jira Cloud | 3.5.2 | N/A | 現行 | Bitbucket Server 4.0 以上 （Stash 3.2.0） | 現行 | 11.10.290 以降 |
|
| 6.2 以降 | 3.3 以上/3.3 以上 | 5.4 以降 | 現行 | Bitbucket Server 4.0 以上 （Stash 2.10 以上） | 現行 | 11.10.290 以降 | 開発パネル |
| 6.1. 以上 | N/A | N/A | 現行 | Bitbucket Server 4.0 以上 （Stash 2.8. 以上） | N/A | N/A | 開発パネル
|
プロジェクト用の開発ツールの設定
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 に開発ツールをセットアップする
互換性のあるバージョンの開発ツールを持っていることをバージョン マトリックスで確認した後、以下の説明にしたがってコード開発ツールを Jira に接続します。
Bitbucket Server、Bamboo、Fisheye、Crucible へのリンク
Jira はアプリケーション リンクを使用して、Bitbucket Server、Bamboo、Fisheye、Crucible に接続されている必要があります。
Bitbucket サーバーの場合、以下のシステム プラグインが必要であることにご注意ください （これらのプラグインは Bitbucket サーバーに既定でバンドルされ、有効化されています）。
- Atlassian Navigation Links Plugin (com.atlassian.plugins.atlassian-nav-links-plugin)
- Bitbucket サーバー開発サマリー プラグイン（bitbucket-jira-development-integration-plugin）。
開発ツール インスタンスを Jira Software Server と同じマシンで実行している場合、そのアプリケーショが異なるウェブ コンテキストを使用していることを確認してください。これにより。OAuth やアプリケーション リンクに関わる認証およびセッションの問題を回避できます。たとえば、FiseEye と Jira を実行していた場合、既定のパスを次のように変更します。
http://localhost:8080/
https://localhost:8060/fisheye (http://localhost:8060/ ではない)
手順説明
GitHub または GitHub Enterprise へのリンク
「Bitbucket または GitHub リポジトリを Jira とリンクする」を参照してください。
GitLab または GitLab Self-Managed へのリンク
「GitLab または GitLab Self-Managed リポジトリと Jira のリンク」を参照してください。
トラブルシューティング
Jira Application Development panel displays error - Couldn't read data