GitHub データを Jira にバックフィルする

バックフィルとは、GitHub 組織からソフトウェア スペースに履歴データをインポートするプロセスを指します。これにより、現在の作業と一緒に以前のデータを表示し、両方のソースを同期させることができます。

GitHub を連携すると、Jira では 6 か月分の履歴が自動的にインポートされます。次の情報がインポートされます。

• すべてのプル リクエスト — Jira 作業項目キーがプル リクエストのタイトルまたは説明、あるいはソース ブランチの名前に含まれている必要があります。

• ビルドとデプロイ — Jira 作業項目キーがワークフローまたはデプロイの一部であるコミット メッセージ、ブランチ名、またはプル リクエストに含まれている場合が対象となります。ビルドとデプロイの Jira へのリンクの詳細については、こちらをご確認ください。

• Jira 作業項目キーを含むコミット — 既定以外のブランチの最新 50 件のコミットのみがバックフィルされます。到達不能なコミット (削除されたブランチからのコミットなど) は除外されます。

• ブランチ — 作業項目キーが次の場所に含まれている場合に限られます。

  • ブランチ名

  • ブランチに関連付けられている最新のプル リクエストのタイトル

  • ブランチの最後のコミット メッセージ

Jira サイトを移行した場合や新しい GitHub 組織に移動した場合に留意すべき点をいくつか紹介します。

• 同期の問題を防ぐため、GitHub 組織に接続する Jira サイトは一度に 1 つだけにしてください。新しい Jira サイトに移行した場合や新しい Jira サイトを作成した場合は、古いサイトから GitHub for Atlassian アプリを切断し、新しいサイトに接続して、バックフィルを実行してリンクとデータを復元してください。バックフィル期間はデータ量によって異なります。大規模なデータセットの場合は、オフピーク時にバックフィルを実行して、リンクされたデータを確認する前に同期のための十分な時間を確保してください。

• 新しい GitHub 組織に移行した場合、ブランチ、コミット、プル リクエストなど、Jira の過去の開発参照は引き続き元の組織のリポジトリを指しています。新しい作業をリンクするには、GitHub for Atlassian を使用して新しい GitHub 組織を Jira に接続し、コミット、ブランチ名、またはプル リクエストのタイトルに Jira 作業項目キーを含めます。Jira の開発パネルでのリポジトリ URL の一括更新や過去の参照の再マッピングはサポートされていません。作業項目の説明やコメントは、一括編集ツールや Marketplace アプリでのみ更新でき、開発パネルでは更新できません。

GitHub データを手動でバックフィルする

GitHub データを手動でバックフィルして、6 か月を超える履歴をインポートしたり、GitHub と Jira の間のステータスの不一致などの同期の問題を修正したりできます。

継続的な同期のギャップや疑わしいエラーに対処するため、手動バックフィルを定期的に実行してください。

GitHub データを手動でバックフィルするには、次の手順に従います。

1. [アプリ]、[アプリを管理] の順に選択します。

2. サイドバーで [GitHub for Atlassian] を選択します。

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

4. 履歴のインポートを開始する日付を選択してから、[Backfill data (データをバックフィル)] を選択します。既定設定の手動インポート プロセスでは、すでにインポートされているデータに加えてデータが追加されます。既存の履歴データをすべて上書きする場合は、[Restart the backfill (バックフィルを再開)] の横にあるチェックボックスをオンにします。