仮想アプライアンスをインポートする

Linux Windows

仮想アプライアンスは、仮想マシン（VM）インスタンスのディスクイメージとハードウェア構成を含むパッケージです。

広く使用されている仮想アプライアンスの形式は OVF 形式です。仮想アプライアンスを OVF 形式でパッケージ化すると、OVF パッケージが生成されます。OVF パッケージは、.ovf 記述子ファイルや、ディスクなどの他のリソースのコレクションを格納するフォルダです。OVF パッケージを 1 つのファイルにアーカイブしたものを OVA ファイルといいます。

このページでは、Compute Engine を使用して仮想アプライアンスからマシンイメージをインポートする手順について説明します。

始める前に

プロジェクトで VM Migration API を有効にします。
ブートディスクがサポート対象のオペレーティングシステムで構成されていることを確認します。

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

Compute Engine を使用して、次の形式のマシンイメージファイルをインポートできます。

Open Virtualization Format（OVF）: 同じバケット内の OVF ファイルと仮想マシンディスク（VMDK）ファイル。
Open Virtual Appliance（OVA）: OVF ファイルと VMDK ファイルを含む 1 つの OVA ファイル。

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

Compute Engine を使用してマシンイメージを Compute Engine マシンイメージにインポートするには、次の操作を行います。

インポートするマシンイメージファイルを準備する
ターゲットプロジェクトを選択する
マシンイメージを Compute Engine にインポートする

インポートするマシンファイルを準備する

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

マシンイメージファイルを Cloud Storage に追加する

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

必要な権限を付与する

マシンイメージを Compute Engine マシンイメージにインポートするには、次の表の説明に従って権限を付与します。

ロール	必要な権限	説明
Storage オブジェクト閲覧者	`roles/storage.objectViewer`	ホストプロジェクト（`service-HOST_PROJECT_NUMBER@gcp-sa-vmmigration.iam.gserviceaccount.com`）のデフォルトの Migrate to Virtual Machines サービスアカウントに、インポートするイメージが存在するバケットに対する `roles/vmmigration.serviceAgent` ロールを付与します。この権限により、Migrate to Virtual Machines がソースイメージにアクセスできるようになります。
VM 移行管理者	`roles/vmmigration.admin`	ホストプロジェクトで、ソースイメージのインポートに使用するユーザーアカウントに `roles/vmmigration.admin` ロールを付与します。
VM Migration サービスアカウント	`roles/vmmigration.serviceAgent`	ホストプロジェクト（`service-HOST_PROJECT_NUMBER@gcp-sa-vmmigration.iam.gserviceaccount.com`）のデフォルトの Migrate to Virtual Machines サービスアカウントに、ターゲットプロジェクトに対する `roles/vmmigration.serviceAgent` ロールを付与します。たとえば、`service-1234567890@gcp-sa-vmmigration.iam.gserviceaccount.com` がホストプロジェクトの Migrate to Virtual Machines サービスアカウントである場合、ターゲットプロジェクトでイメージを作成できるように、このサービスアカウントに `roles/vmmigration.serviceAgent` ロールを付与する必要があります。

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

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

マシンイメージを Compute Engine にインポートする

マシンイメージを Compute Engine にインポートするには、Google Cloud CLI または REST API コマンドを使用します。

マシンイメージをインポートすると、Compute Engine はターゲットプロジェクトに一時的なリソース（VM やディスクなど）を作成します。これらの一時リソースは、マシンイメージのインポートプロセスが完了すると削除されます。

gcloud

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

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

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

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

詳しくは、gcloud migration vms image-imports をご覧ください。

REST API

REST API を使用してマシンイメージを Compute Engine にインポートするには、次の操作を行います。

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

POST https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/imageImports?imageImportId=IMPORT_NAME
{
"cloudStorageUri": "SOURCE_FILE",
"machineImageTargetDefaults": {
"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 の形式で入力します。バケット内のオブジェクトのパスを取得するには、オブジェクトのメタデータを表示するをご覧ください。マシンイメージは、.ova ファイルと .ovf ファイルからのみインポートできます。
IMAGE_NAME: 作成するマシンイメージの名前。命名ルールの詳細については、命名規則をご覧ください。
TARGET_PROJECT: マシンイメージを作成するターゲットプロジェクト。ターゲットプロジェクトをまだ追加していない場合は、ターゲットプロジェクトを追加するの手順に沿って追加してください。

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

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

フィールド名説明

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

machineImageTargetDefaults.targetProject

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

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

machineImageTargetDefaults.machine_image_name 作成するマシンイメージの名前。命名規則について詳しくは、リソースの命名規則をご覧ください。

machineImageTargetDefaults.description （省略可）マシンイメージの説明。

machineImageTargetDefaults.machine_type （省略可）マシンイメージを作成するマシン。マシンタイプを指定しない場合、Compute Engine は、ソースマシンイメージの情報に基づいて関連するマシンタイプを選択します。

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

machineImageTargetDefaults.tags マシンイメージに適用するタグを追加します。リソースのタグを管理するをご覧ください。

machineImageTargetDefaults.additionalLicenses

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

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

machineImageTargetDefaults.service_account マシンイメージで使用されるターゲットプロジェクトのサービスアカウントを指定します。デフォルトでは、マシンイメージにサービスアカウントは割り当てられていません。
マシンイメージから Compute Engine インスタンスを作成し、そこでアプリケーションを実行する場合は、インスタンスで他の gcloud CLI サービスや API へのアクセスが必要になる場合があります。Compute Engine インスタンスを作成する前に、これらのサービスや API にアクセスするために必要な権限を持つターゲットプロジェクトでサービスアカウントを作成します。そのサービスアカウントをここに指定します。詳細については、サービスアカウントとして実行するよう VM を設定するをご覧ください。
サービスアカウントを Compute Engine インスタンスに接続するには、Compute Engine ホストプロジェクトのユーザーアカウントに必要な権限が必要です。詳細については、ターゲットプロジェクトのサービスアカウントの権限の構成をご覧ください。

machineImageTargetDefaults.shielded_instance_config （省略可）このインスタンスで Shielded VM を有効にします。Shielded VM は、ルートキットやブートキットによる攻撃を防ぐ一連のセキュリティ制御により強化されています。Shielded VM とはをご覧ください。

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

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

machineImageTargetDefaults.osAdaptationParameters.licenseType

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

machineImageTargetDefaults.osAdaptationParameters.network_interfaces

Compute Engine では、必要に応じて複数のネットワークインターフェース（NIC）を使用するマシンイメージを作成できます。各インターフェースを異なる VPC ネットワークに接続し、gcloud CLI の異なる VPC ネットワークに対してそのマシンイメージのアクセス権を付与します。
ネットワークインターフェースを追加する前に、次の点に注意してください。

複数のネットワークインターフェースを同じ VPC ネットワークに接続することはできません。構成は保存できますが、VM のインスタンス化は失敗します。
Compute Engine インスタンスをマシンイメージからインスタンス化した後に、test-clone または cut-over を使用して、作成されたインスタンスでネットワークインターフェースの追加または削除を行うことはできません。別のターゲットの詳細を使用して test-clone または cut-over を繰り返し、インスタンスを再作成できます。
ネットワークインターフェースを追加または削除するには:

[ネットワークインターフェースを追加] を選択して、Compute Engine インスタンスに別のネットワークインターフェースを追加します。最初のネットワークインターフェースと同じオプションを設定できます。

詳細については、複数のネットワークインターフェースを持つインスタンスの作成をご覧ください。

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

machineImageTargetDefaults.encryption

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

顧客管理の暗号鍵（CMEK）を使用して、マシンイメージのデータを暗号化します。これらの暗号鍵は、ユーザーによって作成、管理、所有されます。詳細については、Cloud KMS 鍵を使用してリソースを保護するをご覧ください。
CMEK を追加する場合は、次の表に示す権限が必要になります。

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

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

{
  "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",
      "machineImageTargetDefaults": {
        "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"
}
```

次のステップ

単一テナントノードについて学習する。
BYOL について学習する。

仮想アプライアンスをインポートする

始める前に

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

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

インポートするマシンファイルを準備する

マシンイメージ ファイルを Cloud Storage に追加する

必要な権限を付与する

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

マシンイメージを Compute Engine にインポートする

gcloud

REST API

次のステップ

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

マシンイメージファイルを Cloud Storage に追加する

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