VM のインポートとエクスポート

Migrate to Virtual Machines のインポートとエクスポート機能を使用すると、CSV ファイルを使用して、移行する VM の作成、エクスポート、変更を行うことができます。

移行の前提条件

インポートとエクスポートの機能を使用する前に、単一の VM または VM のグループを移行するための前提条件を確認する必要があります。CSV で移行を管理する場合と同じ前提条件が適用されます。

移行の詳細については、次の Migrate to Virtual Machines のドキュメントをご覧ください。

インポートとエクスポートの概要

エクスポート機能を使用して、ソース VM または現在の VM とターゲットの詳細を含む CSV ファイルを出力し、外部で編集してから、CSV を Migrate to Virtual Machines にアップロードして移行を定義できます。

CSV ファイルの編集時やインポート時に、移行の最終の状態を念頭に置いてください。つまり、CSV ファイルで設定を定義すると、インポート プロセスによって、インポートした CSV ファイルの状態と一致するように、移行とグループの作成、グループ メンバーの変更、ターゲットの詳細の更新が行われます。

インポート処理用の CSV ファイルを定義する方法はいくつかあります。

CSV ファイルの形式が正しくない場合や、特定の移行の詳細が無効な場合は、Migrate to Virtual Machines へのアップロード中にエラーが発生します。

CSV ファイル形式

アクションを実行する前に、インポートされる CSV ファイルは解析され、次の基準で検証されます。

  • 移行とソース VM は、ソース名、ソース リージョン、ソース VM 表示名とソース VM の ID の組み合わせとして認識されます。
  • 同じ移行またはソース VM を複数の行に含めることはできません。
  • 1 つのファイルで処理できる移行またはソース VM は 100 個までです。
  • ソース VM の移行が存在しない場合は、ソース VM の存在が検証され、その VM 用に新しい移行が作成されます。
  • インポートとエクスポートの移行機能では、ターゲットの詳細列をタイプとリソースの命名規則に基づいて検証します。障害を回避するには、ターゲット プロジェクトにリソースが存在するかどうかを手動で検証する必要があります。
  • これらのフィールドで CSV ファイルに含まれていない列は無視され、移行は更新されません。ただし、空の値はそれぞれの移行を更新し、その移行からデータを削除します。
  • 列には、VM ごとに複数の値（ネットワーク タグやラベルなど）を改行で区切って含めることができます。例については、テンプレート ファイルをエクスポートするをご覧ください。

検証エラーによりインポートを続行できない場合があります。たとえば、無効なヘッダー行や、行数が多すぎるファイルによって検証エラーがスローされます。

CSV ファイルのフィールド

ヘッダー行は想定されています。移行または移行元の VM を識別する次の列が含まれている必要があります。その他の列は省略可能であり、存在する場合はインポート時にのみ更新されます。不明なヘッダー列は無視されます。

CSV ファイルに次の必須項目があります。

  • ソース名
  • リージョン
  • [ソース VM 表示名] または [ソース VM の ID] のいずれか

オプションのフィールドの詳細については、移行した VM のターゲットの構成をご覧ください。

テンプレート ファイル

CSV ファイルを定義する際に活用可能なテンプレート ファイルをエクスポートできます。テンプレートの CSV ファイルは空です。ただし、ヘッダー行には必須フィールドとオプション フィールドの詳細が含まれます。サンプル行には、各列の書式の例が記載されています。テンプレートでは、ターゲットの詳細は CSV ファイルの列で表されます。

事前入力された CSV ファイルをエクスポートする

ソース VM に基づいて移行を作成する場合、あるいは既存の移行または移行グループに変更を加える場合は、まず移行の現在のステータスを表す CSV ファイルをエクスポートする必要があります。

事前に入力された CSV ファイルをエクスポートするには、以下の操作を行います。

  1. Google Cloud コンソールで [Migrate to Virtual Machines] ページを開きます。

  2. ソース VM のリストをエクスポートするには:

    1. [ソース] タブを選択します。
    2. インベントリからエクスポートするソース VM を選択します。
    3. [エクスポート] をクリックして CSV ファイルをダウンロードします。

  3. 既存の移行のグループをエクスポートするには:

    1. [グループ] タブを選択します。
    2. グループリストから、エクスポートするグループを選択します。
    3. [エクスポート] をクリックして CSV ファイルをダウンロードします。

CSV ファイルをインポートする

CSV ファイルをアップロードすると、検証が行われます。ファイル内の一部行にエラーがある場合は、それらのエラーが表示されます。このような行をスキップして、残りの行をインポートすることもできます。

検証済みの CSV ファイルをアップロードすると、承認対象のインポート プランが表示されます。承認するとファイルがインポートされます。

CSV ファイルをインポートする手順は次のとおりです。

  1. Google Cloud コンソールで [Migrate to Virtual Machines] ページを開きます。
  2. [グループ] タブを選択し、[インポート] を選択します。

  3. インポート ファイルを参照します。CSV ファイル形式で 100 KB 以下であることが必要です。

  4. [アップロード] を選択します。

    エラーがある場合は、このステップでエラーが表示されます。[エラーをスキップして続行] を選択できます。

  5. 続行すると、インポート プランが表示されます。これにより、呼び出されているアクションと参照されているリソースの詳細がわかります。

  6. [インポート開始] を選択してインポート プランを承認し、インポートを開始します。インポート プランに各ステップの進捗状況が反映されます。

  7. インポートに失敗した場合は、表示されるエラー メッセージを確認します。いずれかのステップに失敗すると、シーケンス全体が停止します。

  8. インポートが成功したら、[グループに移動] を選択して [グループ] ページに戻り、更新されたリソースを確認します。

インポート プランを確認する

インポート プランは、インポート ファイル内で検出された変更に従って生成されたアクションのリストです。表示される可能性のあるメッセージの種類は次のとおりです。

  • 移行を作成してください。
  • グループを作成してください。
  • グループから移行を削除してください。
  • 移行をグループに追加してください。
  • 移行のターゲットの詳細を更新します。

インポート プランを承認すると、インポートの進行中に各項目のステータスが更新されます。レポートには、Pending、Running、Done、Failed などのステータスが表示され、各項目との相関関係が示されます。

移行テンプレート ファイルをエクスポートする

CSV ファイルを正しくフォーマットした詳細の移行テンプレート ファイルをエクスポートできます。

移行テンプレート ファイルをエクスポートする手順は次のとおりです。

  1. Google Cloud コンソールで [Migrate to Virtual Machines] ページを開きます。
  2. [グループ] タブを選択します。
  3. [インポート] を選択します。
  4. [テンプレートをエクスポート] を選択すると、ファイル Template.csv をダウンロードするよう求めるプロンプトが表示されます。