在虚拟机上启用虚拟显示

本文档介绍如何在虚拟机 (VM) 实例上启用或停用虚拟显示。

如果虚拟机上运行的应用需要显示设备，但您不需要 GPU 的性能，则将虚拟机配置为使用虚拟显示设备。通过在虚拟机上启用虚拟显示，您可以在虚拟机上运行虚拟显示设备，例如远程系统管理工具、远程桌面软件和屏幕截取。

准备工作

• 设置身份验证（如果尚未设置）。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例，您可以按如下方式向 Compute Engine 进行身份验证。
  

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

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

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

     gcloud init

  2. Set a default region and zone.

  Terraform

  如需在本地开发环境中使用本页面上的 Terraform 示例，请安装并初始化 gcloud CLI，然后使用您的用户凭据设置应用默认凭据。

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command:

     gcloud init

  3. If you're using a local shell, then create local authentication credentials for your user account:

     gcloud auth application-default login

     You don't need to do this if you're using Cloud Shell.

  如需了解详情，请参阅 Set up authentication for a local development environment。

  REST

  如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 gcloud CLI 的凭据。

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

  gcloud init

  如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

所需的角色

如需获得在虚拟机上启用或停用虚拟显示所需的权限，请让您的管理员为您授予项目的 Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供在虚拟机上启用或停用虚拟显示所需的权限。如需查看所需的确切权限，请展开所需权限部分：

您也可以使用自定义角色或其他预定义角色来获取这些权限。

价格

在虚拟机上启用或停用虚拟显示不会产生任何相关费用。

限制

对于启用了虚拟显示的虚拟机，存在以下限制：

• 如果虚拟机运行的是版本 v20190312 之前基于 x64 的 Windows 操作系统映像，则在虚拟机上启用虚拟显示后，您必须按照本文档中所述安装虚拟显示驱动程序。如果虚拟机运行的是更高的操作系统映像版本，则表示该驱动程序已安装在操作系统映像上。

• 只有在客机操作系统启动并初始化虚拟显示驱动程序后，您才能在虚拟机上使用虚拟显示设备。

• 您不能在运行 Sandy Bridge CPU 平台的虚拟机上使用虚拟显示设备。

• 您不能在 T2A Arm 虚拟机上使用虚拟显示设备。

在虚拟机上启用虚拟显示

如需在虚拟机上启用虚拟显示，请选择本文档中所述的以下方法之一：

• 创建启用了虚拟显示的虚拟机。

• 在现有虚拟机上启用虚拟显示。

如果虚拟机运行的是版本 v20190312 之前基于 x64 的 Windows 操作系统映像，则在虚拟机上启用虚拟显示后，请按照本文档中所述安装虚拟显示驱动程序。

创建启用了虚拟显示的虚拟机

如需创建启用了虚拟显示的虚拟机，请选择以下选项之一：

gcloud compute instances create VM_NAME \
    --enable-display-device \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

resource "google_compute_instance" "instance_virtual_display" {
  name         = "instance-virtual-display"
  machine_type = "f1-micro"
  zone         = "us-central1-c"

  # Set the below to true to enable virtual display
  enable_display = true

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  network_interface {
    # A default network is created for all GCP projects
    network = "default"
    access_config {
    }
  }
}

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

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "project/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "displayDevice": {
    "enableDisplay": true
  },
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

如需详细了解如何创建虚拟机，请参阅创建并启动 Compute Engine 实例。

在现有虚拟机上启用虚拟显示

在虚拟机上启用虚拟显示之前，请务必停止虚拟机。

如需在现有虚拟机上启用虚拟显示，请选择以下选项之一：

gcloud compute instances update VM_NAME \
    --enable-display-device \
    --zone=ZONE

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

{
  "enableDisplay": true
}

在现有虚拟机上停用虚拟显示

在虚拟机上停用虚拟显示之前，请务必停止虚拟机。

如需在现有虚拟机上停用虚拟显示，请选择以下选项之一：

gcloud compute instances update VM_NAME \
    --no-enable-display-device \
    --zone=ZONE

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

{
  "enableDisplay": false
}

安装虚拟显示驱动程序

如果您已在运行版本 v20190312 之前的 Windows 操作系统映像的 Windows 虚拟机上启用了虚拟显示，则如需在该虚拟机上使用虚拟显示设备，您必须安装 Google Cloud 提供的虚拟显示驱动程序。如果虚拟机运行较新的操作系统映像版本，则表示该驱动程序已安装，您可以跳过此部分。

如需在启用了虚拟显示的虚拟机上安装虚拟显示驱动程序，请执行以下操作：

1. 连接到 Windows 虚拟机。

2. 以管理员身份打开 PowerShell 终端。

3. 安装 google-compute-engine-driver-gga 组件：

   googet install google-compute-engine-driver-gga
   

4. 重启虚拟机。

重启虚拟机后，您可以按照下一部分所述验证是否已正确安装驱动程序。

验证虚拟显示驱动程序的安装情况

如果您必须按照上一部分中所述在 Windows 虚拟机上手动安装虚拟显示驱动程序，则可以通过执行以下操作来验证安装是否成功：

1. 连接到 Windows 虚拟机（如果尚未连接到）。

2. 打开设备管理器。

3. 在 Device Manager 列表的 Display adapters 列表中，确保列出了 Google Graphics Array (GGA) 驱动程序。

   如果未列出该驱动程序，请按照本文档中所述重新安装虚拟显示驱动程序。

后续步骤

• 了解如何在 Linux 虚拟机上设置 Chrome 远程桌面。

• 了解如何使用 RDP 连接到 Windows 虚拟机。