現在、Migrate to Virtual Machines（旧称 Migrate for Compute Engine）が表示されています。Migrate for Compute Engine のバージョン 4.x については、4.x のドキュメントをご覧ください。

仮想ディスクイメージをインポートする

Migrate to Virtual Machines では、仮想ディスクイメージを Compute Engine イメージにインポートできます。必要なソフトウェアと構成を備えた仮想ディスクイメージがオンプレミス環境にある場合、これらの仮想ディスクイメージを Compute Engine にインポートし、そのイメージを使用して仮想マシンインスタンスまたは永続ディスクを作成することで、時間を節約できます。

始める前に

プロジェクトで VM Migration API を有効にします。VM Migration API の有効化の詳細については、Migrate to Virtual Machines サービスを有効にするをご覧ください。
ディスク上のオペレーティングシステムが Migrate to Virtual Machines でサポートされていることを確認します。詳細については、サポートされているオペレーティングシステムをご覧ください。
インポートする仮想ディスクイメージファイルがサポートされていることを確認します。

サポートされているファイル形式

Migrate to Virtual Machines を使用して、次の形式の仮想ディスクイメージファイルをインポートできます。

仮想マシンディスク（VMDK）- 推奨オプション。VMDK ファイルはより高速にインポートされます。
QEMU copy-on-write（QCOW）
QEMU copy-on-write 2（QCOW2）
QEMU 拡張ディスク形式（QED）
VPC
仮想ディスクイメージ（VDI）
仮想ハードディスク v2（VHDX）
仮想ハードディスク（VHD）

これらの形式に加えて、.tar.gz として圧縮された raw ファイルもサポートされています。圧縮ファイルには、disk.raw という名前のファイルが 1 つだけ含まれている必要があります。

イメージのインポートプロセス

Migrate to Virtual Machines を使用して仮想ディスクイメージを Compute Engine イメージにインポートするには、次の操作を行います。

インポートする仮想ディスクイメージファイルを準備する
ターゲットプロジェクトを選択する
仮想ディスクイメージを Compute Engine にインポートする

インポートする仮想ディスクファイルを準備する

仮想ディスクイメージを Compute Engine イメージにインポートするには、まずインポートする仮想ディスクイメージファイルを準備する必要があります。以降のセクションでは、これらのタスクについて詳しく説明します。

仮想ディスクイメージファイルを Cloud Storage に追加する

仮想ディスクイメージを Compute Engine イメージにインポートするには、まず仮想ディスクイメージファイルを Cloud Storage に追加する必要があります。詳細については、ファイルシステムからオブジェクトをアップロードするをご覧ください。パフォーマンスを向上させるため、イメージを作成するクラウドリージョン内のバケットに仮想ディスクイメージファイルをアップロードすることをおすすめします。

必要な権限を付与する

仮想ディスクイメージを Compute Engine イメージにインポートするには、次の表の説明に従って権限を付与します。

ロール	必要な権限	説明
ストレージオブジェクト閲覧者	`roles/storage.objectViewer`	仮想ディスクイメージを Compute Engine イメージにインポートできるようにするには、この権限をホストプロジェクトのサービスアカウントに付与します。
VM 移行管理者	`roles/vmmigration.admin`	この権限をホストプロジェクトに付与すると、新しい Migrate to Virtual Machines ソースの作成と、他のすべての移行オペレーションの実行が可能になります。
VM Migration サービスアカウント	`roles/vmmigration.serviceAgent`	移行された仮想マシンインスタンス（VM）、ディスク、イメージをターゲットプロジェクトに作成できるように、この権限をターゲットプロジェクトに付与します。

ターゲットプロジェクトを選択する

Compute Engine イメージをホストするには、ターゲットプロジェクトを作成または選択する必要があります。ターゲットプロジェクトは、Compute Engine イメージの宛先プロジェクトを定義します。ターゲットプロジェクトの作成または選択の詳細については、ターゲットプロジェクトの追加をご覧ください。

仮想ディスクイメージを Compute Engine にインポートする

仮想ディスクイメージを Compute Engine にインポートするには、Google Cloud コンソール、Google Cloud CLI、または REST API コマンドを使用します。

コンソール

Google Cloud コンソールを使用して仮想ディスクイメージを Compute Engine にインポートするには、次の操作を行います。

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

[Migrate to Virtual Machines] ページに移動
[イメージインポート] タブを選択します。
[イメージを作成] をクリックします。

イメージの特性を定義します。次の表に、イメージに設定できるパラメータを示します。

セクションタイトルフィールド名説明

全般名前作成するイメージの名前。命名ルールの詳細については、命名規則をご覧ください。

イメージインポート ID イメージインポートリソースを表す ID。Compute Engine にイメージをインポートすると、Migrate to Virtual Machines はまずイメージインポートリソースを作成します。イメージインポートリソースはイメージインポートプロセスを表します。イメージインポート ID を使用して、イメージのインポートプロセスでインポートされたイメージへのリンクを取得できます。

ソース Cloud Storage ファイルイメージのインポート元となるファイル。[参照] をクリックして現在のプロジェクト内のバケットのリストを表示し、イメージのインポート元となるファイルを選択します。
別のプロジェクトのバケットからイメージをインポートする場合は、bucket/folder/file の形式でパスを入力する必要があります。バケット内のオブジェクトのパスを取得するには、オブジェクトのメタデータを表示するをご覧ください。パスをコピーする際は、gs:// 接頭辞をコピーしないでください。
イメージは、.vmdk ファイルと .tar.gz ファイルからのみインポートできます。

リージョンイメージを作成するリージョン。サポートされているリージョンのリストについては、リージョンとゾーンをご覧ください。

ターゲットプロジェクトイメージを作成するターゲットプロジェクト。ターゲットプロジェクトをまだ追加していない場合は、ターゲットプロジェクトを追加するの手順に沿って追加してください。

ファミリー（省略可）イメージファミリーを選択します。Compute Engine には、自動化システムが最新のイメージを参照できるようにするためのイメージファミリーが用意されています。管理者は、イメージのセットをイメージファミリーとしてグループ化できます。詳細については、公開イメージファミリーをご覧ください。

説明（省略可）イメージの説明を追加します。

OS 適応をスキップ OS 適応をスキップするには、[OS 適応をスキップ] をクリックしてオンの位置に切り替えます。
Google Cloud で正しく機能させるには、インポートしたイメージから作成された VM の構成を変更する必要があります。このような変更は OS 適応と呼ばれます。Migrate to Virtual Machines は、イメージのインポートプロセスで OS 適応を自動的に実行します。詳細については、Google Cloud で実行するように VM インスタンスを適応させるをご覧ください。

一般化イメージを一般化するには、[一般化] をオンの位置に切り替えます。イメージからインスタンスを作成すると、Windows によって一意の情報がインスタンスに追加されます。一般化は、この情報を削除して、同じイメージから複数のインスタンスを作成できるようにするプロセスです。

ライセンス

ライセンスの種類

Compute Engine は、デプロイ済み VM に従量課金制（PAYG）ライセンスとお客様所有ライセンスの使用（BYOL）をサポートしています。サポートされているオペレーティングシステムで説明されているように、移行した VM のデフォルトのライセンスタイプは、移行したオペレーティングシステムに基づいて Migrate to Virtual Machines によって割り当てられます。
オペレーティングシステムが複数のライセンスタイプをサポートしている場合は、デフォルトのライセンスタイプをオーバーライドして、PAYG または BYOL のライセンスタイプを明示的に指定できます。

追加ライセンス

追加ライセンス

インポートしたイメージから作成された VM インスタンスに、有効な URL 形式を使用して最大 10 個のライセンスを追加できます。たとえば、次の URL 形式を使用してライセンスを追加できます。


https://www.googleapis.com/compute/beta/projects/windows-sql-cloud/global/licenses/sql-server-2012-enterprise

ラベルプロジェクトを整理するには、ラベルを Key-Value ペアとしてリソースに追加します。ラベルを使用してリソースを整理するをご覧ください。

暗号化 Google が管理する暗号鍵 Google が管理する暗号鍵を使用してインポートプロセスでデータを暗号化するには、このオプションを選択します。詳細については、保存時にデータを暗号化するをご覧ください。

顧客管理の暗号鍵

顧客管理の暗号鍵（CMEK）を使用して、インポートプロセス中のデータと、インポートプロセスによって作成されたイメージのデータを暗号化するには、このオプションを選択します。データを保護する鍵について特定のコンプライアンスや規制の要件がある場合、CMEK を使用してデータの暗号化と復号を行うことができます。これらの暗号鍵は、ユーザーによって作成、管理、所有されます。詳細については、Cloud KMS 鍵を使用してリソースを保護するをご覧ください。
CMEK を追加する場合は、次の表に示す権限が必要になります。

ロール	必要な権限	説明
Cloud VM Migration サービスアカウント	`roles/vmmigration.serviceAgen`	インポートプロセス中に作成されたイメージのデータを暗号化するには、この権限を Compute Engine サービスアカウントに付与します。
Compute Engine サービスエージェント	`roles/compute.serviceAgent`	インポートプロセスでデータを暗号化するには、この権限を Migrate to Virtual Machines サービスエージェントに付与します。

[作成] を選択します。

gcloud

Google Cloud CLI を使用して仮想ディスクイメージを Compute Engine にインポートするには、次のリクエストを使用します。

gcloud alpha migration vms image-imports create IMAGE_NAME \
--source-file=SOURCE_FILE \
--target-project=projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT

次のように置き換えます。

HOST_PROJECT_ID: 仮想ディスクイメージを移行するホストプロジェクトの名前。
REGION_ID: イメージインポートプロセスを実行するリージョン。イメージは最も近いマルチリージョンに作成されます。リージョンでイメージを作成する場合は、singleRegionStorage が true に設定されていることを確認してください。サポートされているリージョンのリストについては、リージョンとゾーンをご覧ください。
SOURCE_FILE: イメージのインポート元となるファイル。パスは gs://bucket/folder/file の形式で入力します。バケット内のオブジェクトのパスを取得するには、オブジェクトのメタデータを表示するをご覧ください。イメージは、.vmdk ファイルと .tar.gz ファイルからのみインポートできます。
IMAGE_NAME: 作成するイメージの名前。命名ルールの詳細については、命名規則をご覧ください。
TARGET_PROJECT: イメージを作成するターゲットプロジェクト。ターゲットプロジェクトをまだ追加していない場合は、ターゲットプロジェクトを追加するの手順に沿って追加してください。

詳細については、gcloud alpha migration vms image-imports をご覧ください。

REST

REST API を使用して仮想ディスクイメージを Compute Engine にインポートするには、次の操作を行います。

次のリクエストを使用して、イメージインポートリソースを作成します。

POST https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/imageImports?imageImportId=IMPORT_NAME
{
"cloudStorageUri": "SOURCE_FILE",
"diskImageTargetDefaults": {
"imageName": "IMAGE_NAME",
"targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT",
...
}
}

次のように置き換えます。

HOST_PROJECT_ID: 仮想ディスクイメージを移行するホストプロジェクトの名前。
REGION_ID: イメージインポートプロセスを実行するリージョン。イメージは最も近いマルチリージョンに作成されます。リージョンでイメージを作成する場合は、singleRegionStorage が true に設定されていることを確認してください。サポートされているリージョンのリストについては、リージョンとゾーンをご覧ください。
SOURCE_FILE: イメージのインポート元となるファイル。パスは gs://bucket/folder/file の形式で入力します。バケット内のオブジェクトのパスを取得するには、オブジェクトのメタデータを表示するをご覧ください。イメージは、.vmdk ファイルと .tar.gz ファイルからのみインポートできます。
IMAGE_NAME: 作成するイメージの名前。命名ルールの詳細については、命名規則をご覧ください。
TARGET_PROJECT: イメージを作成するターゲットプロジェクト。ターゲットプロジェクトをまだ追加していない場合は、ターゲットプロジェクトを追加するの手順に沿って追加してください。

この例の IMPORT_NAME は、イメージインポートリソースを表す ID です。Compute Engine にイメージをインポートすると、Migrate to Virtual Machines はまずイメージインポートリソースを作成します。イメージインポートリソースはイメージインポートプロセスを表します。IMPORT_NAME を使用すると、イメージインポートプロセスの一環としてインポートされたイメージへのリンクを取得できます。

サポートされているイメージインポート作成リクエストのフィールドについては、次の表をご覧ください。

フィールド名説明

cloudStorageUri 文字列
イメージのインポート元となるファイルのパス。パスは gs://bucket/folder/file の形式で入力します。バケット内のオブジェクトのパスを取得するには、オブジェクトのメタデータを表示するをご覧ください。
イメージは、.vmdk ファイルと .tar.gz ファイルからのみインポートできます。

diskImageTargetDefaults.targetProject

文字列
TargetProject のパス。イメージを作成するターゲットプロジェクト。詳細については、ターゲットプロジェクトの API リファレンスをご覧ください。例:
projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT
この例では、次のように置き換えます。

HOST_PROJECT_ID: 仮想ディスクイメージを移行するホストプロジェクトの名前。
TARGET_PROJECT: イメージを作成するターゲットプロジェクト。

diskImageTargetDefaults.imageName 文字列
作成されるイメージの名前。命名規則について詳しくは、リソースの命名規則をご覧ください。

diskImageTargetDefaults.description 文字列
（省略可）イメージの説明。

diskImageTargetDefaults.familyName 文字列
（省略可）イメージファミリーを選択します。Compute Engine には、自動化システムが最新のイメージを参照できるようにするためのイメージファミリーが用意されています。管理者は、イメージのセットをイメージファミリーとしてグループ化できます。詳細については、公開イメージファミリーをご覧ください。詳細については、公開イメージファミリーをご覧ください。

diskImageTargetDefaults.labels マップ（キー: 文字列, 値: 文字列）
プロジェクトを整理するには、ラベルを Key-Value ペアとしてリソースに追加します。リソースのラベル付けをご覧ください。

diskImageTargetDefaults.additionalLicenses

文字列[]
有効な URL 形式を使用して、インポートしたイメージから作成された VM インスタンスに、最大 10 個のライセンスを追加できます。たとえば、次の URL 形式を使用してライセンスを追加できます。


https://www.googleapis.com/compute/beta/projects/windows-sql-cloud/global/licenses/sql-server-2012-enterprise

diskImageTargetDefaults.singleRegionStorage ブール値
イメージ storageLocations をリージョンにする場合は、このフラグを true に設定します。このフラグを false に設定すると、最も近いマルチリージョンが選択されます。

diskImageTargetDefaults.dataDiskImageImport ブール値
OS 適応をスキップする場合は、このフラグを true に設定します。
Google Cloud で正しく機能させるには、インポートしたイメージから作成された VM の構成を変更する必要があります。このような変更は OS 適応と呼ばれます。Migrate to Virtual Machines は、イメージのインポートプロセスで OS 適応を自動的に実行します。詳細については、Google Cloud で実行するように VM インスタンスを適応させるをご覧ください。

diskImageTargetDefaults.osAdaptationParameters.licenseType

文字列
イメージに使用するライセンスの種類。Compute Engine は、デプロイ済み VM に従量課金制（PAYG）ライセンスとお客様所有ライセンスの使用（BYOL）をサポートしています。サポートされているオペレーティングシステムで説明されているように、移行した VM のデフォルトのライセンスタイプは、移行したオペレーティングシステムに基づいて Migrate to Virtual Machines によって割り当てられます。
オペレーティングシステムが複数のライセンスタイプをサポートしている場合は、デフォルトのライセンスタイプをオーバーライドして、PAYG または BYOL のライセンスタイプを明示的に指定できます。

diskImageTargetDefaults.osAdaptationParameters.generalize ブール値
イメージを一般化する場合は、このフラグを true に設定します。
イメージからインスタンスを作成すると、Windows によって一意の情報がインスタンスに追加されます。一般化は、この情報を削除して、同じイメージから複数のインスタンスを作成できるようにするプロセスです。

diskImageTargetDefaults.encryption 文字列
インポートプロセスでデータの暗号化に使用する Google 管理の暗号鍵。詳細については、保存時にデータを暗号化するをご覧ください。

encryption

文字列
顧客管理の暗号鍵（CMEK）を使用して、インポートプロセス中のデータと、インポートプロセスによって作成されたイメージのデータを暗号化するには、このオプションを選択します。データを保護する鍵について特定のコンプライアンスや規制の要件がある場合、CMEK を使用してデータの暗号化と復号を行うことができます。これらの暗号鍵は、ユーザーによって作成、管理、所有されます。詳細については、Cloud KMS 鍵を使用してリソースを保護するをご覧ください。
CMEK を追加する場合は、次の表に示す権限が必要になります。

ロール	必要な権限	説明
Cloud VM Migration サービスアカウント	roles/vmmigration.serviceAgent	インポートプロセス中に作成されたイメージのデータを暗号化するには、この権限を Compute Engine サービスアカウントに付与します。
Compute Engine サービスエージェント	roles/compute.serviceAgent	インポートプロセスでデータを暗号化するには、この権限を Migrate to Virtual Machines サービスエージェントに付与します。

次のサンプルのようなレスポンスが表示されます。

{
  "name": "projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "createTime": "2023-10-31T09:12:26.94928636Z",
    "target": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME",
    "verb": "create",
    "apiVersion": "v1",
    "@type": "type.googleapis.com/google.cloud.vmmigration.v1.OperationMetadata"
  }
}

次のコマンドを使用してオペレーションをポーリングし、イメージインポートジョブが完了したかどうかを確認します。

GET https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID

次のように置き換えます。

HOST_PROJECT_ID: 仮想ディスクイメージの移行元のホストプロジェクトの名前。
REGION_ID: イメージインポートプロセスを実行するリージョン。イメージは最も近いマルチリージョンに作成されます。リージョンでイメージを作成する場合は、singleRegionStorage が true に設定されていることを確認してください。サポートされているリージョンのリストについては、リージョンとゾーンをご覧ください。
OPERATION_ID: 移行ジョブのオペレーション ID。

次のサンプルのようなオペレーション完了レスポンスが表示されます。

  {
    "done": true,
    "name": "projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
    "response": {
      "@type": "type.googleapis.com/google.cloud.vmmigration.v1.ImageImport",
      "name": "projects/<HOST_PROJECT_ID>/locations/us-central1/imageImports/IMPORT_NAME",
      "cloudStorageUri": "SOURCE_FILE",
      "createTime": "2023-10-31T09:04:04.413664947Z",
      "diskImageTargetDefaults": {
        "imageName": "IMAGE_NAME",
        "targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
      },
      "recentImageImportJobs": [
        {
          "name": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME/imageImportJobs/image-import-job",
          "diskImageTargetDetails": {
           "imageName": "IMAGE_NAME",
           "targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
        },
         "state": "PENDING"
       }
      ]
    },
    "metadata": {
      "createTime": "2023-10-31T09:04:04.416740716Z",
      "endTime": "2023-10-31T09:05:36.79987142Z",
      "target": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME",
      "verb": "create",
      "apiVersion": "v1",
      "@type": "type.googleapis.com/google.cloud.vmmigration.v1.OperationMetadata"
    }
  }

次のコマンドを使用して、イメージインポートジョブの完了をモニタリングします。
```
GET https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/imageImports/IMPORT_NAME/imageImportJobs/image-import-job
```
次のように置き換えます。
- HOST_PROJECT_ID: 仮想ディスクイメージの移行元のホストプロジェクトの名前。
- REGION_ID: イメージインポートプロセスを実行するリージョン。イメージは最も近いマルチリージョンに作成されます。リージョンでイメージを作成する場合は、singleRegionStorage が true に設定されていることを確認してください。サポートされているリージョンのリストについては、リージョンとゾーンをご覧ください。
- IMPORT_NAME: イメージインポートリソースを表す ID。Compute Engine にイメージをインポートすると、Migrate to Virtual Machines はまずイメージインポートリソースを作成します。イメージインポートリソースはイメージインポートプロセスを表します。IMPORT_NAME を使用すると、イメージインポートプロセスの一環としてインポートされたイメージへのリンクを取得できます。
次のサンプルのようなジョブ完了レスポンスが表示されます。
```
{
  "createTime":"2023-10-31T09:12:27.053788394Z",
  "createdResources":[
    "https://www.googleapis.com/compute/v1/projects/USER_PROJECT/global/images/IMAGE_NAME"
  ],
  "diskImageTargetDetails": {
    "imageName":"IMAGE_NAME",
    "targetProject":"projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
  },
  "endTime":"2023-10-31T09:16:50.224865783Z",
  "name":"projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME/imageImportJobs/image-import-job",
  "state":"SUCCEEDED"
}
```

仮想ディスク イメージをインポートする

始める前に

サポートされているファイル形式

イメージのインポート プロセス

インポートする仮想ディスク ファイルを準備する

仮想ディスク イメージ ファイルを Cloud Storage に追加する

必要な権限を付与する

ターゲット プロジェクトを選択する

仮想ディスク イメージを Compute Engine にインポートする

コンソール

gcloud

REST

仮想ディスクイメージをインポートする

イメージのインポートプロセス

インポートする仮想ディスクファイルを準備する

仮想ディスクイメージファイルを Cloud Storage に追加する

ターゲットプロジェクトを選択する

仮想ディスクイメージを Compute Engine にインポートする