Jira のバックフィル プロセスを理解する

GitHub for Jira を通じて GitHub 組織に接続すると、その組織からの履歴が Jira にインポートされます (バックフィリングと呼ばれます)。

プル リクエスト、デプロイ、ビルド、コミットの 6 か月間の履歴を自動的にバックフィルし、ブランチのすべての履歴をインポートします。

組織が接続されると、その履歴が引き続き同期されるため、常に最新の状態を維持できます。

インポートされたデータに問題がある場合は、既定の 6 か月を超えるデータをインポートするか、現在の履歴を上書きするかを選択できます。

手動バックフィルを実行する

バックフィル プロセスを開始するには、次の手順を実行します。

1. トップ メニューで、[アプリ] > [アプリを管理する] > [Jira 向け GitHub] の順に移動します。

2. GitHub 組織の設定 () を選択してから、[バックフィルの続行] を選択します。

3. 履歴のインポートを開始する日付を選択してから、[Backfill data (データをバックフィル)] を選択します。

このバックフィル プロセスには時間がかかる場合があります。Jira では作業を続けることができ、バックフィル プロセスはバックグラウンドで実行されます。

バックフィルの仕組み

現在の履歴よりもさらに前の日付を選択した場合、新たに対象となったデータのみがバックフィルされます。

たとえば、すでに 6 か月間の履歴がバックフィルされていて、12 か月間の履歴を選択した場合、欠落している 6 か月間の履歴のみがインポートされます。

ただし、[Restart the backfill… (バックフィルを再開...] チェックボックスをオンにすると、既存の履歴が上書きされ、12 か月間すべてのデータがインポートされます。すでにバックフィルされたデータへの変更に気づくのは、GitHub にあるデータと一致しない場合のみです。

バックフィル データの要件

Jira にバックフィルするには、履歴データが特定の基準を満たしている必要があります。

ブランチの場合 (次のうち少なくとも 1 つが当てはまる必要があります)

• ブランチ名に課題キーが含まれている。

• ブランチに関連付けられている最新のプル リクエストのタイトルに課題キーが含まれている。

• ブランチの最後のコミット メッセージに課題キーが含まれている。

コミットの場合

• 既定のブランチからすべてのコミットがバックフィルされます。コミット メッセージには Jira 課題キーが含まれている必要があります。

• 既定以外のブランチから直近 50 件のコミットのみがバックフィルされます。

• 到達不能なコミット (例: 削除されたブランチから) はバックフィルされません。

プル リクエストの場合

• ステータスに関係なく、すべてのプル リクエストがバックフィルされます。プル リクエストのタイトル、プル リクエストの説明、プル リクエストのソース ブランチの名前のいずれかに Jira 課題キーを含める必要があります。

ビルドとデプロイの場合

• 課題キーを含むすべてのビルドとデプロイのデータがバックフィルされます。ビルドとデプロイに課題キーを含める方法をご確認ください