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

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

Jira で開発情報を表示する

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

1. ボードに移動する

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

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

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

開発環境での次のアクションは、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 Cloud のみ: コミット メッセージに課題キーがあるプル リクエストにコミットを含めます (コミットはマージ コミットにできません)。

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

レビュー

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

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

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