ネストされた仮想化を有効にする

このドキュメントでは、仮想マシン（VM）インスタンスでネストされた仮想化を有効にする方法と、ネストされた VM を作成可能かどうか確認する方法について説明します。次のいずれかの方法を使用して、VM でネストされた仮想化を有効にします。

  • （推奨）VM の作成時に enableNestedVirtualization フィールドを true に設定するか、VM を更新することで、ネストされた仮想化を新規または既存の VM 上で有効にします。カスタム イメージの作成や特別なライセンスキーの使用が不要であるため、この方法をおすすめします。

  • 特別なライセンスキーを使用して、ネストされた仮想化を有効にします。ブートディスクを作成して、ネストされた仮想化の特別なライセンスキーを使用してカスタム イメージを作成し、それを使用する VM を作成します。

始める前に

  • まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

ネストされた仮想化を新しい VM で直接有効にする

VM 上でネストされた仮想化を直接有効にするには、次の操作を行います。

gcloud

次の gcloud compute instances create コマンドを使用して、ネストされた仮想化を有効にした L1 VM を作成します。

gcloud compute instances create VM_NAME \
  --enable-nested-virtualization \
  --zone=ZONE \
  --min-cpu-platform="Intel Haswell"

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

  • VM_NAME: ネストされた仮想化が有効になっている新しい L1 VM の名前

  • ZONE: ネストされた仮想化を有効にした新しい L1 VM のゾーン

REST

次の instances.insert メソッドを使用して、ネストされた仮想化を有効にした L1 VM を作成します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  ...
  "name": "VM_NAME",
  ...
  "minCpuPlatform": "Intel Haswell",
  "advancedMachineFeatures": {
    "enableNestedVirtualization": true
  },
  ...
}

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

  • PROJECT_ID: プロジェクト ID

  • ZONE: ネストされた仮想化を有効にした新しい L1 VM のゾーン

  • VM_NAME: ネストされた仮想化が有効になっている新しい L1 VM の名前

既存の VM で直接ネストされた仮想化を有効にする

既存の VM でネストされた仮想化を有効にするには、次の手順を行います。

gcloud

  1. 次の gcloud compute instances export コマンドを使用して、VM のプロパティをエクスポートします。

    gcloud compute instances export VM_NAME \
  --destination=YAML_FILE_PATH \
  --zone=ZONE

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

    • VM_NAME: プロパティをエクスポートする VM の名前

    • YAML_FILE_PATH: エクスポートした構成データを保存する .yaml ファイルのパスとファイル名

    • ZONE: VM が配置されているゾーン

  2. FILE_PATH に保存された VM 構成ファイルで、enableNestedVirtualization の値を更新します。値がファイルに含まれていない場合は、次の行を追加します。

    advancedMachineFeatures:
  enableNestedVirtualization: true

  3. 次の gcloud compute instances update-from-file コマンドを使用して、enableNestedVirtualization の値で VM を更新します。

    gcloud compute instances update-from-file VM_NAME \
  --source=FILE_PATH \
  --most-disruptive-allowed-action=RESTART \
  --zone=ZONE

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

    • VM_NAME: 更新する VM の名前

    • FILE_PATH: 更新された VM 構成ファイルへのパス。

    • ZONE: 更新する VM が配置されたゾーン

REST

次の instances.update メソッドを使用して、enableNestedVirtualization の値を更新します。

PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?most_disruptive_allowed_action=RESTART

{
  ⋮
  "advanced_machine_features": {
    ⋮
    "enableNestedVirtualization": "true"
  },
  ⋮
}

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

  • PROJECT_ID: プロジェクトの ID

  • ZONE: VM が配置されているゾーン

  • VM_NAME: プロパティをエクスポートする VM の名前

特別なライセンスキーを使用してネストされた仮想化を有効にする

L1 VM で VMX を有効にする特別なライセンスキーを使用して、カスタム イメージを作成することで、ネストされた仮想化を VM で有効にすることもできます。ライセンスキーには追加料金はかかりません。

  1. 公開イメージまたはカスタム イメージからブートディスクを作成します。次の例では、イメージ プロジェクトに debian-cloud を使用し、イメージ ファミリーに debian-10 を使用します。既存のディスクを含む VM インスタンスがすでにある場合は、この手順をスキップできます。

    gcloud

    gcloud compute disks create DISK_NAME \
  --zone=ZONE \
  --image-project=debian-cloud \
  --image-family=debian-10

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

    • DISK_NAME: 新しいディスクの名前

    • ZONE: ディスクを作成するゾーン

    REST

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks

{
  ...
  "name": "DISK_NAME",
  "sourceImage": "projects/debian-cloud/global/images/family/debian-10",
  ...
}

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

    • PROJECT_ID: プロジェクト ID

    • ZONE: ディスクを作成するゾーン

    • DISK_NAME: 新しいディスクの名前

  2. ネストされた仮想化に必要な特別なライセンスキーを使用して、カスタム イメージを作成します。

    gcloud

    gcloud compute images create IMAGE_NAME \
  --source-disk DISK_NAME \
  --source-disk-zone ZONE \
  --licenses "https://www.googleapis.com/compute/v1/projects/vm-options/global/licenses/enable-vmx"

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

    • IMAGE_NAME: 新しいイメージの名前

    • DISK_NAME: 以前に作成したディスクの名前

    • ZONE: イメージを作成するゾーン

    REST

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images

{
  ...
  "licenses": ["projects/vm-options/global/licenses/enable-vmx"],
  "name": "IMAGE_NAME",
  "sourceDisk": "zones/ZONE/disks/DISK_NAME",
  ...
}

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

    • PROJECT_ID: プロジェクト ID

    • IMAGE_NAME: 新しいイメージの名前

    • ZONE: イメージを作成するゾーン

    • DISK_NAME: 以前に作成したディスクの名前

  3. 必要に応じて、特別なライセンスでイメージを作成した後、ソースディスクを削除します。

    gcloud

    gcloud compute disks delete DISK_NAME --zone=ZONE

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

    • DISK_NAME: 削除するディスクの名前

    • ZONE: 削除するディスクを含むゾーン

    REST

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

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

    • PROJECT_ID: プロジェクト ID

    • ZONE: 削除するディスクを含むゾーン

    • DISK_NAME: 削除するディスクの名前

  4. 特別なライセンスで新しいイメージを使用する VM を作成します。最小 CPU プラットフォームは "Intel Haswell" にする必要があります。

    gcloud

    gcloud compute instances create VM_NAME \
    --zone=ZONE \
    --min-cpu-platform "Intel Haswell" \
    --image IMAGE_NAME

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

    • VM_NAME: VM の名前

    • ZONE: VM を作成するゾーン

    • IMAGE_NAME: 以前に作成されたイメージの名前

    REST

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  ...
  "name": "VM_NAME",
  "minCpuPlatform": "Intel Haswell",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "IMAGE_NAME"
      }
    }
  ]
  ...
}

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

    • PROJECT_ID: プロジェクト ID

    • VM_NAME: VM の名前

    • ZONE: VM を作成するゾーン

    • IMAGE_NAME: 以前に作成されたイメージの名前

ネストされた仮想化が VM で有効になっていることを確認する

  1. VM インスタンスに接続します。

    gcloud compute ssh VM_NAME

    VM_NAME は、接続する VM の名前に置き換えます。

  2. ネストされた仮想化が有効になっていることを確認します。ネストされた仮想化が有効であれば、0 以外のレスポンスが返されます。

    grep -cw vmx /proc/cpuinfo

次のステップ