開発作業で課題を参照する

管理者が Jira Software を Bitbucket Cloud、GitHub、GitLab、またはその他のサポートされている開発ツールに接続している際は、課題とコードをシームレスに統合できます。

はじめる前に

Bitbucket、GitHub、またはその他のサポートされている開発ツールでのコードのコミット、ビルド、デプロイ中に Jira 課題を参照するには、次の手順を実行します。

  1. リンクする Jira 課題の課題キー (「JRA-123」など) を探します。このキーは、Jira のいくつかの場所で確認できます。
    • ボードでは、カードの下部に課題キーが表示されます。
    • 課題の詳細では、ページの上部にあるブレッドクラム ナビゲーションに課題キーが表示されます。
    課題と課題キーの詳細はこちらをご確認ください。

  2. ブランチ名に課題キーを付けて、リポジトリで新しいブランチをチェックアウトします。例: git checkout -b JRA-123-<branch-name>

  3. 変更をブランチにコミットする際は、課題キーをコミット メッセージで使用して、それらのコミットを Jira 課題の開発パネルにリンクします。例: git commit -m "JRA-123 <summary of commit>"

  4. プル リクエストを作成する際は、プル リクエストのタイトルに課題キーを使用します。

ツールにより Jira が認識されて同期されるようにするには、接続先のリポジトリに何らかをプッシュする必要があります。場合によっては、完全な同期が行われるまでに数分かかることがあります。

ブランチをプッシュすると、Jira 課題に開発情報が表示されます。

プル リクエストのタイトルに課題キーを含めると、Jira へのリンクが自動で作成されます。

何も表示されない場合は、Jira の課題キーが大文字で正しくフォーマットされていることをご確認ください。たとえば、「jra-123」ではなく「JRA-123」とする必要があります。

Jira で開発情報を表示する

 

リンクされた開発情報を Jira 課題で表示するには、次の手順に従います。

  1. 課題に移動します。

  2. [開発] で、追加情報を表示する件のプル リクエスト、ブランチ、またはコミットの数を選択します。

リンクされた開発情報を Jira ボードで表示するには、次の手順に従います。

  1. ボードに移動する

  2. 課題カードの開発アイコンをチェックして、課題にリンクされたプル リクエスト、ブランチ、コミット、またはデプロイがあるかどうかを確認します。

  3. カーソルをアイコンに合わせて開発アクティビティの詳細を表示し、クリック スルーして接続されている開発ツールに移動します。

開発アイコンは、次の場合に限り Jira ボードに表示されます。

  • ボード上の課題の少なくとも 1 つに開発データがリンクされている。

  • ボードに含まれる課題が 100 個未満である。

課題に影響を与える開発アクション

開発環境での次のアクションは、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 の場合、ビルドのいずれかのコミットでコミット メッセージに Jira 課題キーが含まれている場合、そのビルドは Jira 課題に自動的にリンクされます。この機能を有効にするには、コミットに課題キーが含まれている必要があります。

Bitbucket Pipelines の場合、ブランチ名に課題キーを含めるだけです。Bitbucket Pipelines の詳細をご確認ください

変更を確認できる「コミット」

課題キーをコミット メッセージに含めて、コミットを Jira 課題にリンクします。

例: git commit -m "JRA-123 <commit message>"

これは、接続された Bitbucket、GitLab、GitHub、GitHub Enterprise、Fisheye ツールでは既定の機能します。

デプロイメント

本番環境やテスト環境などの環境へのデプロイは、デプロイに関連付けられたコミットのコミット メッセージに課題キーが含まれている場合にリンクされます。この機能を有効にするには、コミットに課題キーが含まれている必要があります。

これは、接続された Bamboo および Bitbucket Pipelines ツールでは既定で機能します。

プル リクエスト

少なくとも、次のいずれかの操作を行います。

  • コミット メッセージに課題キーがあるプルリクエストにコミットを含めます。コミットはマージコミットにならないことにご注意ください。

  • プルリクエストのタイトルに課題キーを含めます。

  • また、ソース ブランチ名が課題キーをそのブランチ名に含んでいることを確認します。

これは、接続された Bitbucket、GitLab、GitHub、GitHub Enterprise ツールでは既定で機能します。

Jira 課題の開発パネルからプル リクエストを作成すると、課題キーが自動的に追加されます。

レビュー

レビューを作成するときに、レビュー タイトルの先頭に課題キーを含めて、レビューを Jira 課題にリンクします。

たとえば、レビューに "JRA-123 <レビューの要約>" という名前を付けて、レビューを開始します。

これは、Jira を Crucible に接続した場合は既定で機能します。

その他のヘルプ