Ative ecrãs virtuais numa VM

Este documento descreve como ativar ou desativar ecrãs virtuais numa instância de máquina virtual (VM).

Se uma aplicação em execução na sua VM exigir um dispositivo de visualização, mas não precisar do desempenho de uma GPU, configure a VM para usar dispositivos de visualização virtuais. Ao ativar os ecrãs virtuais numa VM, pode executar dispositivos de ecrã virtual na VM, como ferramentas de gestão de sistemas remotos, software de ambiente de trabalho remoto e captura de ecrã.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

    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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    Terraform

    Para usar os exemplos do Terraform nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as credenciais predefinidas da aplicação com as suas credenciais de utilizador.

      Instale a CLI Google Cloud.

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

      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.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para mais informações, consulte Set up authentication for a local development environment.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud.

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções necessárias

Para receber as autorizações de que precisa para ativar ou desativar ecrãs virtuais numa VM, peça ao seu administrador para lhe conceder a função de IAM Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para ativar ou desativar ecrãs virtuais numa VM. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para ativar ou desativar ecrãs virtuais numa VM:

  • Para ativar ou desativar ecrãs virtuais numa VM existente: compute.instances.updateDisplayDevice na VM
  • Para criar uma VM com ecrãs virtuais ativados:
    • compute.instances.create no projeto
    • Para usar uma imagem personalizada para criar a VM: compute.images.useReadOnly na imagem
    • Para usar um instantâneo para criar a VM: compute.snapshots.useReadOnly no instantâneo
    • Para usar um modelo de instância para criar a VM: compute.instanceTemplates.useReadOnly no modelo de instância
    • Para atribuir uma rede antiga à VM: compute.networks.use no projeto
    • Para especificar um endereço IP estático para a VM: compute.addresses.use no projeto
    • Para atribuir um endereço IP externo à VM quando usar uma rede antiga: compute.networks.useExternalIp no projeto
    • Para especificar uma sub-rede para a VM: compute.subnetworks.use no projeto ou na sub-rede escolhida
    • Para atribuir um endereço IP externo à VM quando usar uma rede VPC: compute.subnetworks.useExternalIp no projeto ou na sub-rede escolhida
    • Para definir os metadados da instância de VM para a VM: compute.instances.setMetadata no projeto
    • Para definir etiquetas para a VM: compute.instances.setTags na VM
    • Para definir etiquetas para a VM: compute.instances.setLabels na VM
    • Para definir uma conta de serviço para a VM usar: compute.instances.setServiceAccount na VM
    • Para criar um novo disco para a VM: compute.disks.create no projeto
    • Para anexar um disco existente no modo de leitura ou leitura/escrita: compute.disks.use no disco
    • Para anexar um disco existente no modo de leitura: compute.disks.useReadOnly no disco

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Preços

Não existem custos associados à ativação ou desativação de ecrãs virtuais numa VM.

Restrições

Para VMs com ecrãs virtuais ativados, aplicam-se as seguintes limitações:

  • Se a sua VM estiver a executar uma imagem do SO Windows baseada em x64 anterior à versão v20190312, depois de ativar os ecrãs virtuais na VM, tem de instalar o controlador do ecrã virtual, conforme descrito neste documento. Se a sua VM estiver a executar uma versão posterior da imagem do SO, o controlador já está instalado na imagem do SO.

  • Só pode usar um dispositivo de visualização virtual na VM depois de o SO convidado ser iniciado e inicializar o controlador de visualização virtual.

  • Não pode usar dispositivos de visualização virtuais em VMs que executam a plataforma de CPU Sandy Bridge.

  • Não pode usar dispositivos de visualização virtuais em VMs Arm T2A.

Ative ecrãs virtuais numa VM

Para ativar os ecrãs virtuais numa VM, selecione um dos seguintes métodos descritos neste documento:

Se a sua VM estiver a executar uma imagem do SO Windows baseada em x64 anterior à versão v20190312, depois de ativar os ecrãs virtuais na VM, instale o controlador do ecrã virtual, conforme descrito neste documento.

Crie uma VM com ecrãs virtuais ativados

Para criar uma VM com ecrãs virtuais ativados, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Criar uma instância.

    Aceda a Criar uma instância

  2. Especifique as propriedades da VM, incluindo o nome, a zona e o tipo de máquina.

  3. Na secção Dispositivo de visualização, selecione a caixa de verificação Ativar dispositivo de visualização.

  4. Para criar a VM, clique em Criar.

gcloud

Para criar uma VM com os ecrãs virtuais ativados, use o comando gcloud compute instances create com o sinalizador --enable-display-device.

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

Substitua o seguinte:

  • VM_NAME: o nome da VM.

  • MACHINE_TYPE: o tipo de máquina a usar para a VM.

  • ZONE: a zona na qual criar a VM.

Terraform

Para criar uma VM com ecrãs virtuais ativados, use o recurso do Terraform com o argumento enable_display definido como true.

Por exemplo, para criar uma VM na zona us-central1-c com os ecrãs virtuais ativados e especificar f1-micro como o tipo de máquina, use o seguinte recurso:


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 {
    }
  }
}

REST

Para criar uma VM com ecrãs virtuais ativados, faça um pedido POST ao método instances.insert. No corpo do pedido, inclua o campo enableDisplay definido como true.

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"
    }
  ]
}

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto no qual criar a VM.

  • ZONE: a zona na qual criar a VM.

  • VM_NAME: o nome da VM.

  • MACHINE_TYPE: o tipo de máquina a usar para a VM.

  • IMAGE_PROJECT: o projeto de imagem que contém a imagem do SO, por exemplo, debian-cloud. Para mais informações sobre os projetos de imagens suportados, consulte o artigo Imagens públicas.

  • IMAGE: especifique uma das seguintes opções:

    • Uma versão específica da imagem do SO, por exemplo, debian-12-bookworm-v20240617.

    • Uma família de imagens, que tem de estar formatada como family/IMAGE_FAMILY. Isto especifica a imagem do SO não descontinuada mais recente. Por exemplo, se especificar family/debian-12, é usada a versão mais recente na família de imagens do Debian 12. Para mais informações sobre a utilização de famílias de imagens, consulte o artigo Práticas recomendadas para famílias de imagens.

Para mais informações sobre como criar uma VM, consulte o artigo Crie e inicie uma instância do Compute Engine.

Ative ecrãs virtuais numa VM existente

Antes de ativar os ecrãs virtuais numa VM, certifique-se de que para a VM.

Para ativar os ecrãs virtuais numa VM existente, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias de VM.

    Aceda à página de instâncias de VM

  2. Na coluna Nome, clique no nome da MV.

    É apresentada a página de detalhes da VM.

  3. Clique em Editar.

    É aberta a página para editar as propriedades da MV.

  4. Na secção Dispositivo de visualização, selecione a caixa de verificação Ativar dispositivo de visualização.

  5. Clique em Guardar.

gcloud

Para ativar os ecrãs virtuais numa VM existente, use o comando gcloud compute instances update com o sinalizador --enable-display-device.

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

Substitua o seguinte:

  • VM_NAME: o nome da VM.

  • ZONE: a zona onde a VM está localizada.

REST

Para ativar os ecrãs virtuais numa VM existente, faça um pedido POST ao método instances.updateDisplayDevice. No corpo do pedido, inclua o campo enableDisplay e defina-o como true.

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

{
  "enableDisplay": true
}

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde a VM está localizada.

  • ZONE: a zona onde a VM está localizada.

  • VM_NAME: o nome da VM.

Desative os ecrãs virtuais numa VM existente

Antes de desativar os ecrãs virtuais numa VM, certifique-se de que para a VM.

Para desativar os ecrãs virtuais numa VM existente, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias de VM.

    Aceda à página de instâncias de VM

  2. Na coluna Nome, clique no nome da MV.

    É apresentada a página de detalhes da VM.

  3. Clique em Editar.

    É aberta a página para editar as propriedades da MV.

  4. Na secção Dispositivo de visualização, desmarque a caixa de verificação Ativar dispositivo de visualização.

  5. Clique em Guardar.

gcloud

Para desativar os ecrãs virtuais numa VM existente, use o comando gcloud compute instances update com a flag --no-enable-display-device.

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

Substitua o seguinte:

  • VM_NAME: o nome da VM.

  • ZONE: a zona onde a VM está localizada.

REST

Para desativar os ecrãs virtuais numa VM existente, faça um pedido POST ao método instances.updateDisplayDevice. No corpo do pedido, inclua o campo enableDisplay e defina-o como false.

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

{
  "enableDisplay": false
}

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde a VM está localizada.

  • ZONE: a zona onde a VM está localizada.

  • VM_NAME: o nome da VM.

Instale o controlador de ecrã virtual

Se ativou os ecrãs virtuais numa VM do Windows que executa uma imagem do SO Windows anterior à versão v20190312, para usar um dispositivo de ecrã virtual na VM, tem de instalar o controlador de ecrã virtual fornecido pela Google Cloud. Se a VM executar uma versão de imagem do SO mais recente, o controlador já está instalado e pode ignorar esta secção.

Para instalar o controlador de ecrã virtual numa VM com ecrãs virtuais ativados, faça o seguinte:

  1. Estabeleça ligação à VM do Windows.

  2. Abra um terminal do PowerShell como administrador.

  3. Instale o componente google-compute-engine-driver-gga:

    googet install google-compute-engine-driver-gga

  4. Reinicie a VM.

Depois de reiniciar a VM, pode verificar se o controlador foi instalado corretamente, conforme descrito na secção seguinte.

Valide a instalação do controlador de visualização virtual

Se teve de instalar manualmente o controlador de visualização virtual numa VM do Windows, conforme descrito na secção anterior, pode verificar se a instalação foi bem-sucedida da seguinte forma:

  1. Se ainda não o tiver feito, estabeleça ligação à VM do Windows.

  2. Abra o Gestor de dispositivos.

  3. Na lista do Gestor de dispositivos, na lista Adaptadores de visualização, certifique-se de que o controlador do Google Graphics Array (GGA) está listado.

    Se o controlador não estiver listado, reinstale o controlador do ecrã virtual, conforme descrito neste documento.

O que se segue?