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

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

はじめる前に

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

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

  2. ブランチ名の先頭で課題キーを使用して、リポジトリで新しいブランチをチェックアウトします。たとえば、git checkout -b JRA-123-<ブランチ名> のようにします。

  3. ブランチに変更をコミットするときは、コミット メッセージの先頭で課題キーを使用して、それらのコミットを Jira 課題の開発パネルにリンクします。たとえば、git commit -m "JRA-123 <コミットの要約>" のようにします。

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

ブランチをプッシュすると、Jira 課題に開発情報が表示されます。リンクされた開発情報を Jira Software で表示するには、次の手順を実行します。

  1. 課題に移動します。

  2. [開発] で、ブランチの数またはコミットの数を選択して、追加情報を表示します。

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

開発環境での次のアクションは、Jira の課題をリンクして更新するものです。Jira 管理者がスマート コミットを有効化している場合は、その他のアクションも使用できます。スマート コミットの使用について詳細をご確認ください

ブランチ

ブランチを作成するときに、ブランチ名の先頭に課題キーを含めて、ブランチを Jira 課題にリンクします。

例: git checkout -b JRA-123-<ブランチ名>

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

Bitbucket Cloud を使用している場合は、Jira 課題から直接ブランチを作成できます。[開発] で、[+] > [ブランチを作成] を選択します。この方法でブランチを作成すると、課題キーがブランチの名前に自動的に追加されます。

ビルド

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

Bamboo の場合、ビルドのいずれかのコミットでコミット メッセージに Jira 課題キーが含まれている場合、そのビルドは Jira 課題に自動的にリンクされます。この機能を有効にするには、コミットに課題キーが含まれている必要があります。

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

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

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

例: git commit -m "JRA-123 <コミット メッセージ>"

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

デプロイメント

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

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

プル リクエスト

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

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

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

  • ソース ブランチについてもブランチ名の先頭に課題キーが含まれていることを確認します。

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

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

レビュー

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

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

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

最終更新日 2021年07月30日)
次でキャッシュ 9:00 PM on Aug 3, 2021 |

その他のヘルプ

コミュニティに質問