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

このドキュメントでは、仮想マシン（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.

  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 compute instances create VM_NAME \
  --enable-nested-virtualization \
  --zone=ZONE \
  --min-cpu-platform="Intel Haswell"

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

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

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

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"
  },
  ⋮
}

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

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
   

次のステップ

• ネストされた VM を作成する
• ネストされた仮想化のトラブルシューティング