開発スペースで作業項目を参照する
管理者が Bitbucket Cloud、GitHub、GitLab、またはその他のサポートされている開発ツールに Jira を接続している場合に、作業項目とコードをシームレスに統合できます。
Atlassian Government 環境は Github 経由でのみ接続できます。
はじめる前に
Jira 管理者は、Bitbucket Cloud を Jira サイトに接続するか、GitHub を Jira サイトに接続するか、または別のサポートされた開発ツールを接続する必要があります。開発ツールとの統合に関する詳細をご確認ください。
チームの Jira スペースで [開発ツールを表示] スペース権限が必要です。スペース権限についてご確認ください。
Bitbucket、GitHub、またはその他のサポートされている開発ツールでのコードのコミット、ビルド、デプロイ中に Jira 作業項目を参照するには、次の手順を実行します。
リンクする Jira 作業項目のキー (「JRA-123」など) を探します。このキーは、Jira のいくつかの場所で確認できます。
• ボードでは、カードの下部に作業項目キーが表示されます。
• 作業項目の詳細では、ページ上部にあるブレッドクラム ナビゲーションにキーが表示されます。
作業項目キーについて確認する。ブランチ名にキーを付けて、リポジトリで新しいブランチをチェックアウトします。たとえば、「
git checkout -b JRA-123-<branch-name>」のようにします。変更をブランチにコミットする際は、キーをコミット メッセージで使用して、それらのコミットを Jira 作業項目の開発パネルにリンクします。たとえば、
git commit -m "JRA-123 <summary of commit>"などとします。プル リクエストを作成する際は、プル リクエストのタイトルにキーを使用します。
ツールにより Jira が認識されて同期されるようにするには、接続先のリポジトリに何らかをプッシュする必要があります。場合によっては、完全な同期が行われるまでに数分かかることがあります。
ブランチをプッシュすると、Jira 作業項目に開発情報が表示されます。
プル リクエストのタイトルにキーを含めると、Jira へのリンクが自動で作成されます。
何も表示されない場合は、Jira の作業項目キーが大文字で正しくフォーマットされていることをご確認ください。たとえば、「jra-123」ではなく「JRA-123」とする必要があります。
Jira で開発情報を表示する
リンクされた開発情報を Jira 作業項目で表示するには、次の手順に従います。
作業項目に移動します。
[開発] で、追加情報を表示する件のプル リクエスト、ブランチ、またはコミットの数を選択します。
リンクされた開発情報を Jira ボードで表示するには、次の手順に従います。
ボードに移動する
作業項目カードの開発アイコンをチェックして、作業にリンクされたプル リクエスト、ブランチ、コミット、またはデプロイがあるかどうかを確認します。
カーソルをアイコンに合わせて開発アクティビティの詳細を表示し、接続されている開発ツールに移動します。
開発アイコンは、次の場合に限り Jira ボードに表示されます。
ボード上の作業項目の少なくとも 1 つに開発データがリンクされている。
ボードに含まれる作業項目が 100 個未満である。
リンクされた開発情報を開発ページで表示するには、次の手順に従います。
スペースのナビゲーションで [開発] を選択します。
プル リクエスト サイクル期間、デプロイ頻度などのメトリックを、[主要指標] セクションで確認できます。
Jira に接続されたアプリからの作業の詳細 (プル リクエストやセキュリティ脆弱性など) を、[関連作業] セクションで確認できます。
[関連作業] セクションの [作業の提案] タブで、注意が必要な作業をハイライトする、カスタマイズされた実用的な提案を確認できます。
以下の条件を満たしていれば、開発ページで開発データを確認できます。
スペース管理者がスペースの開発機能を有効にした
開発アプリが接続され、データが Jira に流れている。
作業項目に影響を与える開発アクション
開発環境での次のアクションは、Jira の作業項目をリンクして更新するものです。Jira 管理者がスマート コミットを有効化している場合は、その他のアクションも使用できます。スマート コミットの使用方法をご確認ください。
ブランチ
ブランチを作成する際にブランチ名に作業項目キーを含めて、ブランチを Jira 作業項目にリンクします。
例: git checkout -b JRA-123-<branch-name>
これは、接続された Bitbucket、GitLab、GitHub、GitHub Enterprise、Fisheye ツールでは既定の機能します。
Bitbucket Cloud、GitHub、または GitLab を使用している場合は、ブランチを Jira 作業項目から直接作成できます。[開発] で [ブランチを作成] を選択します。ブランチをこの方法で作成すると、キーがブランチの名前に自動で追加されます。
ビルド
ビルド情報は、接続された Bamboo および Bitbucket Pipelines ツールでは既定で機能します。
Bamboo の場合、ビルドのいずれかのコミットでコミット メッセージにキーが含まれている場合、そのビルドは作業項目に自動的にリンクされます。この機能を有効にするには、コミットにキーが含まれている必要があります。
Bitbucket Pipelines の場合、ブランチ名にキーを含めるだけです。Bitbucket Pipelines の詳細をご確認ください。
変更を確認できる「コミット」
コミット メッセージに作業項目キーを含めて、コミットを Jira 作業項目にリンクします。
例: git commit -m "JRA-123 <commit message>"
これは、接続された Bitbucket、GitLab、GitHub、GitHub Enterprise、Fisheye ツールでは既定の機能します。
デプロイメント
本番環境やテスト環境などの環境へのデプロイは、デプロイに関連付けられたコミットのコミット メッセージにキーが含まれている場合にリンクされます。この機能を有効にするには、コミットにキーが含まれている必要があります。
これは、接続された Bamboo および Bitbucket Pipelines ツールでは既定で機能します。
プル リクエスト
少なくとも、次のいずれかの操作を行います。
プル リクエストのタイトルに作業項目キーを含めます。
また、ソース ブランチ名がキーをそのブランチ名に含んでいることを確認します。
Bitbucket Cloud のみ: コミット メッセージにキーがあるプル リクエストにコミットを含めます (コミットはマージ コミットにできません)。
Jira 作業項目の開発パネルからプル リクエストを作成すると、キーが自動的に追加されます。
レビュー
レビューを作成するときに、レビュー タイトルの先頭にキーを含めて、レビューを Jira 作業項目にリンクします。
たとえば、レビューに "JRA-123 <レビューの要約>" という名前を付けて、レビューを開始します。
これは、Jira を Crucible に接続した場合は既定で機能します。
この内容はお役に立ちましたか?