JCMAt (Jira Cloud Migration Assistan) による移行時のプロジェクト名とプロジェクト キーの競合
プラットフォームについて: Data Center のみ - この記事は、Data Center プラットフォームのアトラシアン製品にのみ適用されます。
この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
要約
Jira Cloud Migration Assistant を使用して Server/DC からクラウドに移行する場合は、一連の事前チェックを実行して、ソースとターゲットに同じ名前またはプロジェクト キーを持つプロジェクトがないことを確認します。
特定する
Jira Cloud Migration Assistant アプリがインストールされていることを確認します。新しい移行プランを作成し、移行対象としてすべてのプロジェクトまたは目的のプロジェクトを選択します。移行プランの事前チェックを実行してソース プロジェクトをスキャンし、クラウド上のターゲット プロジェクトと比較します。競合がある場合、出力は次のようになります。
プロジェクト セクションに展開可能なドロップダウン矢印があることに注目してください。これを選択すると、競合しているプロジェクトが正確にわかります。
ソリューション
クラウドの重複プロジェクトを削除する
スコープ内のプロジェクトがすでに本番稼働中のプロジェクトではなく、JCMA によって以前に移行されたプロジェクトであることを確認してください。
移行プランを実行すると、データはクラウドに移行されます。このデータは JCMA によって削除されないため、同じプロジェクトの後続の移行プランについては、プロジェクトがすでにクラウドに存在することから、移行に失敗します。複数のテストの実行時にこのシナリオに遭遇した場合は、プロジェクト設定内またはプロジェクト ダッシュボードで [ゴミ箱に移動] を選択してください。その後、必ずゴミ箱からプロジェクトを削除してください。
> [プロジェクト] の順に選択します。- サイドバーから [ごみ箱] を選択します。
- 企業管理対象プロジェクトを見つけて、[•••] > [完全に削除する] の順に選択します。
ソース インスタンスのプロジェクトの名前を変更する
ターゲット クラウド サイトにソースとは異なる既存のプロジェクトがすでに存在する場合、推奨されるアプローチは、ソース インスタンスのプロジェクトの名前を変更することです。
プロジェクト キーまたはプロジェクト名 (あるいは両方) を編集する
- [管理] (
) > [プロジェクト] の順に選択してから、関連するプロジェクトを選択します。 - 変更するプロジェクトを見つけます。
- 変更するプロジェクトの [アクション] 列で [編集] を選択します。
- プロジェクト キーとプロジェクト名を編集し、[詳細を保存] をクリックします。インストール済みのアプリのプロジェクト タイプのみを使用できます。
プロジェクト キーの編集後に期待されること
プロジェクトですぐにインデックスの再作成を開始します。移行プランを続行する前に、この処理を完了する必要があります。インデックスの再作成はバックグラウンドで実行できます。重要な変更については、「プロジェクト キーを編集する」を参照してください。これらの変更には次のようなものがあります。
更新後のタスク
- プロジェクトのエンティティ リンクの修正 — Jira を別のアトラシアン製品に接続している場合、Jira プロジェクトと他のアプリケーションの関連 "プロジェクト" (例: Confluence スペース) 間でエンティティ リンクが自動的に作成されます。Jira プロジェクトのキーを変更した場合、「プロジェクト間でリンクを作成する」の説明に従って、プロジェクトのエンティティ リンクを修正する必要があります。
- Jira Software のアジャイル ボードのフィルターの更新 - Jira Software のアジャイル ボードが古いプロジェクト キーを使用している場合、ボードのフィルターを更新し、新しいプロジェクト キーを反映させる必要がある場合があります。これを行わないと、名前が変更されたプロジェクトの課題をボードで表示できなくなる場合があります。
壊れたリンク
- リンクは元のプロジェクト キーを参照しているため、ソース環境では機能するように見えます。ただし、このプロジェクトがクラウドに移行されると、元のプロジェクト キーを参照していたリンクはクラウド プロジェクトを指すようになります。この挙動を説明するシナリオを次に示します。
- 移行プランは、ターゲット クラウド サイトにソース プロジェクト ABC と既存のプロジェクト ABC があるため、失敗します。
- ユーザーは、競合を解消するためにソース プロジェクトを ABC から DEF に変更します。
- ソースのリンクは https://jira.server.com/browse/ABC-123 と表示されます。プロジェクト キーを編集すると、ユーザーはこのリンクから https://jira.server.com/browse/DEF-123 にリダイレクトされます。これは、Jira に認識されているのは元のプロジェクト キーであるためです。
- このプロジェクトをクラウドに移行すると、リンク https://jira.server.com/browse/ABC-123は壊れます。アトラシアン サポートは、ベース URL がターゲット クラウドを指すように更新できる可能性があります。ただし、ABC-123 はクラウドの既存のプロジェクトの課題キーであり、ソースからの元のプロジェクト キーがクラウドで今後参照されることはありません。
- これらのリンクをソース上で手動で更新して、新しいプロジェクト キー DEF-123 を指すようにすることをお勧めします。この処理は移行前に行ってください。
JQL クエリ
- フィルターはソース インスタンスでは機能するように見えますが、移行前に更新する必要があります。リンクと同様に、これらのフィルターは古いプロジェクト キーを参照するため、このデータはクラウドに保存されません。JQL クエリを更新することによってのみ、データが正しく移行されることを確認できます。ボード フィルター、ダッシュボードのフィルター ガジェット、およびその他のグローバル クエリを新しいキーで更新することをお勧めします。
開発ツール
- プロジェクトがクラウドに移行された時点で、この機能は壊れます。
- 影響を受けるすべてのユーザー / 開発者が影響範囲を想定できるようにしてください。
- すべての開発ツールを新しいプロジェクト キーに合わせて再設定する必要があります。使用中の開発ツールで再設定が可能かどうかを必ず確認してください。すべてがすべて該当するわけではありません。