Jira 移行における構成の重複の解決

Jira データを Data Center から Cloud に段階的に移行する場合や、複数の Jira インスタンスを統合する場合、同じ設定が複数の場所に存在することがあります。たとえば、移行のあるフェーズで「Customer ID」カスタム フィールドを移行したとします。その後、別のフェーズで再び「Customer ID」を移行すると、移行先の Cloud サイトに「Customer ID」カスタム フィールドの重複が発生する可能性があります。

Jira Cloud Migration Assistant を使用して移行する際、現行の仕組みでは「Customer ID(migrated)」、「Customer ID(migrated 1)」、「Customer ID(migrated 2)」などのサフィックスが付いた新しいコピーがクラウド サイトに作成されます。これにより、重複する構成が大量に発生し、移行後の手動クリーンアップの負担が増大する可能性があります。Jira Cloud Migration Assistant がデータをリンクする仕組みをご確認ください

改良された Jira Cloud Migration Assistant の移行前チェックでは、移行前に重複の可能性を事前に特定し、重複による競合を解決するための体系的な方法を提供します。

現在、構成の重複を解決する機能は、アーリー アクセス プログラムに参加している限られた数のお客様にのみご利用いただけます。アーリー アクセス プログラムへの参加をご希望の場合は、クラウド移行マネージャーに詳細をお問い合わせください。

機能の仕組み

移行前チェックの一環として、段階的な移行中に重複してしまう構成が検出されます。これには以下が含まれます。

  • カスタム フィールド

  • カスタム フィールド スキーム

  • カスタム フィールド オプション

  • FieldLayout

  • FieldLayoutScheme

  • フィルター

  • 課題タイプ スキーム (Cloud では作業タイプ スキーム)

  • 課題タイプ (Cloud では作業タイプ)

  • 課題ステータス (Cloud では "ステータス")

  • 画面

  • 課題タイプ画面スキーム (Cloud では作業タイプ画面スキーム)

  • 通知スキーム

  • 権限スキーム

  • 優先度

  • 優先度スキーム

  • プロジェクト ロール (Cloud では "スペース ロール")

  • ボード

  • 画面スキーム

  • ワークフロー

  • ワークフロースキーム

この機能により、可能な場合は構成の競合が自動的に解決されます。安全に解決できない競合については、顧客にオプションの選択を求めます。

次の 4 つのアクションのいずれかで解決できます。

  • 移行先の構成を使用する

  • 移行元の構成で上書きする

  • 構成をマージする

  • 新しい構成を作成する

はじめる前に

移行前チェックを実行する前に、以下を行う必要があります。

  1. Jira Cloud Migration Assistant の概要と、データが移行される仕組みを理解する。

  2. Migration Assistant をインストールまたはアップデートする。

  3. 移行前チェックリストの必須タスクを完了する。

  4. 移行に向けてアプリとユーザーを評価する。

構成の重複を解決する手順

ステップ 1: [構成エンティティの更新ルール] カードを見つける

  1. 手順に従って移行計画を作成します。移動するプロジェクト、ボード、フィルター、ユーザー、グループを選択します。

  2. [Save and run pre-migration checks (保存して移行前チェックを実行)] を選択します。

  3. 移行前チェック中に、「構成エンティティの更新ルール」カードを探します。[CSV ファイルをダウンロード] を選択します。

構成エンティティの更新ルール カード

4. 各構成で利用可能なオプションが表示されます。必要に応じて CSV ファイルを編集します。編集した CSV ファイルをアップロードし直すには、[CSV ファイルをアップロード] を選択します。

表のオプション

影響

再利用

  • [REUSE] を選択すると、Cloud インスタンスの構成が再利用されます。

OVERRIDE

  • [OVERRIDE] (上書き) を選択すると、Data Center から構成が取り込まれます。

MERGE_SOURCE

  • サポートされている場合は、[MERGE_SOURCE] を選択すると、互換性のある構成要素がマージされます (たとえば、カスタム フィールド スキームの課題タイプ リストのマージ)。

  • 一部の属性をマージできない場合は、移行元 (Data Center) の値が保持されます。

MERGE_DESTINATION

  • サポートされている場合は、[MERGE_DESTINATION] を選択すると、互換性のある構成要素がマージされます (たとえば、カスタム フィールド スキームの課題タイプ リストのマージ)。

  • 一部の属性をマージできない場合は、移行先 (Cloud) の値が保持されます。

既定

  • カスタム フィールド エンティティに対して行った選択を使用したい場合は、[DEFAULT] を選択します。

  • この選択は、オプション、既定値、バージョンの順序など、カスタム フィールドの子エンティティでのみ利用できます。

  • たとえば、最初の CSV をアップロードするときに [DEFAULT] を選択した場合、カスタム フィールドに対して行った選択が選ばれます。

DECIDE_LATER

  • 不明な場合は [DECIDE_LATER] を選択します。

  • これにより、決定を後回しにできます。検証の完了後に決定する必要があります。

  • エンティティごとに個別に決定できます (たとえば、カスタム フィールドや課題タイプごとなど)。

ステップ 2: アップロードした CSV のチェックを実行する

  1. 変更を検証するには、[Run check (チェックを実行)] を選択します。

  2. チェックに失敗する場合は、エラーを含む CSV ファイルをダウンロードして、発生したエラーを解決してください。[Run check (チェックを実行)] を再度選択します。引き続きチェックに失敗する場合は、サポートにお問い合わせください。
    編集した CSV ファイルをアップロードし直すには、[CSV ファイルをアップロード] を選択します。

[チェックを実行] ボタン

ステップ 3: 有効な構成 CSV をダウンロードする

  1. チェックが完了したら、有効な構成 CSV をダウンロードして、自動的に解決された構成を確認します。構成の決定方法をご確認ください

    1. selected_choice 列を参照して各エンティティの自動選択された項目を検証し、Notes 列を参照してエンティティに関する追加情報を確認します。

    2. このファイルは参照用です。変更やアップロードは行わないでください。

有効な構成 CSV セクション

ステップ 4: 競合する構成エンティティの CSV をダウンロードする

  1. 競合する構成エンティティ CSV をダウンロードして、必須の構成を手動で選択する必要があるエンティティを確認します。

    1. CSV の各行には、エンティティ タイプ、その移行元と移行先、および利用可能な構成の選択肢に関する情報が含まれています。

    2. Choices (選択) 列には、情報が次の形式で含まれています。 

      choiceId|remediationStrategy|name|databaseId|availableWhenconditions

    3. 選択した項目の choice ID (選択 ID) を Choice (選択) 列からコピーし、Customer_selected_choice_id 列に貼り付けます。

    4. 選択を行うには、CSV ユーティリティ ツールを使用することをお勧めします。[有効な構成 CSV] セクションの上にある [JAR をダウンロード] を選択して、ツールをインストールします。CSV ツールの使用方法を確認する

  2. [CSV ファイルをアップロード] を選択して、編集した CSV ファイルをアップロードし直します。システムによって選択内容が検証されます。

  3. 残りの移行前チェックを確認して修正したら、[Review migration (移行のレビュー)] を選択します。

    通常の手順に従って、移行を完了します。移行の確認方法をご覧ください

競合する構成エンティティ セクション

CSV ユーティリティ ツールを使用する

CSV ユーティリティ ツールは、CSV での一括編集に役立ちます。

CSV ユーティリティ ツール ホームページ

ツールを使用するには:

  1. [CSV ファイルをアップロード] セクションで、競合する構成エンティティの CSV をアップロードします。

  2. オプション (任意) で以下をアップロードすることもできます:

    1. 手動で選択を行う代わりにその CSV の選択内容を再利用するための、参照 CSV を再利用セクションにある、以前の移行またはテスト移行の競合する構成エンティティの CSV。

    2. 自動解決されたエンティティを確認するための、有効な構成 CSV セクションにある読み取り専用の有効な構成 CSV。

  3. [アップロードして続行] を選択します。

  4. 自動的に解決されるエンティティを確認するには、[自動解決済み] タブを選択します。アップロードされた有効な構成 CSV の情報がここに表示されます。特別な操作は不要です。

[自動解決済み] タブ

5. [決定事項] タブには、アクションが必要なエンティティが表示されます。前回の移行/テスト移行の CSV からの選択内容が自動入力されます。[選択] (Choices) 列のドロップダウンから必要なエンティティを確認して選択します。

[決定事項] タブ

6. 選択内容を保存するには、[すべての選択を保存] を選択します。

  • 更新された CSV ファイルをダウンロードするには、[CSV をダウンロード] を選択します。

この CSV を移行前チェック画面に再度アップロードして、移行を進めることができます。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。