Ativar telas virtuais em uma VM

Linux Windows

Este documento descreve como ativar ou desativar telas virtuais em uma instância de máquina virtual (VM).

Se um aplicativo em execução na VM exigir um dispositivo de exibição, mas você não precisar do desempenho de uma GPU, configure a VM para usar dispositivos de exibição virtuais. Ao ativar as telas virtuais em uma VM, é possível executar dispositivos de exibição virtuais nela, como ferramentas de gerenciamento de sistema remoto, softwares de área de trabalho remota e captura de tela.

Antes de começar

Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:
Selecione a guia para como planeja usar as amostras nesta página:
Console

Quando você usa o console Google Cloud para acessar serviços Google Cloud e APIs, não é necessário configurar a autenticação.
gcloud
1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
  gcloud init
  Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
  
  Observação:se você já instalou a CLI gcloud, execute o comando gcloud components update para verificar se tem a versão mais recente.
Defina uma região e uma zona padrão.

Terraform

Para usar os exemplos do Terraform nesta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.

Instale a CLI do Google Cloud.
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário:
```
gcloud auth application-default login
```
Não é necessário fazer isso se você estiver usando o Cloud Shell.

Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

REST

Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

Instale a CLI do Google Cloud.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber as permissões necessárias para ativar ou desativar telas virtuais em uma VM, peça ao administrador para conceder a você o papel do IAM de Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para ativar ou desativar telas virtuais em uma VM. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para ativar ou desativar telas virtuais em uma VM:

Para ativar ou desativar as telas virtuais em uma VM atual: compute.instances.updateDisplayDevice na VM
Para criar uma VM com telas virtuais ativadas:
- compute.instances.create no projeto
- Usar uma imagem personalizada para criar a VM: compute.images.useReadOnly na imagem
- Utilizar um snapshot para criar a VM: compute.snapshots.useReadOnly no snapshot
- Usar um modelo de instância para criar a VM: compute.instanceTemplates.useReadOnly no modelo de instância
- Atribuir uma rede legada à VM: compute.networks.use no projeto
- Especificar um endereço IP estático para a VM: compute.addresses.use no projeto
- Atribuir um endereço IP externo à VM ao usar uma rede legada: compute.networks.useExternalIp no projeto
- Especificar uma sub-rede para a VM: compute.subnetworks.use no projeto ou na sub-rede escolhida
- Atribuir um endereço IP externo à VM ao usar uma rede VPC: compute.subnetworks.useExternalIp no projeto ou na sub-rede escolhida
- Definir os metadados da instância da VM: compute.instances.setMetadata no projeto
- Definir tags para a VM: compute.instances.setTags na VM
- Definir rótulos para a VM: compute.instances.setLabels na VM
- Definir uma conta de serviço para a VM usar: compute.instances.setServiceAccount na VM
- Criar um disco para a VM: compute.disks.create no projeto
- Anexar um disco atual no modo somente leitura ou de leitura e gravação: compute.disks.use no disco
- Anexar um disco atual no modo somente leitura: compute.disks.useReadOnly no disco

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Preços

Não há custos associados à ativação ou desativação de telas virtuais em uma VM.

Restrições

Para VMs com telas virtuais ativadas, as seguintes limitações se aplicam:

Se a VM estiver executando uma imagem do SO Windows baseada em x64 anterior à versão v20190312, depois de ativar as telas virtuais na VM, será necessário instalar o driver da tela virtual, conforme descrito neste documento. Se a VM estiver executando uma versão mais recente da imagem do SO, o driver já estará instalado na imagem do SO.
Só é possível usar um dispositivo de exibição virtual na VM depois que o SO convidado é inicializado e inicializa o driver da tela virtual.
Não é possível usar dispositivos de exibição virtual em VMs que executam a plataforma de CPU Sandy Bridge.
Não é possível usar dispositivos de exibição virtual em VMs Arm T2A.

Ativar telas virtuais em uma VM

Para ativar telas virtuais em uma VM, selecione um dos métodos descritos neste documento:

Crie uma VM com telas virtuais ativadas.
Ative as telas virtuais em uma VM atual.

Se a VM estiver executando uma imagem do SO Windows baseada em x64 anterior à versão v20190312, depois de ativar as telas virtuais na VM, instale o driver da tela virtual, conforme descrito neste documento.

Criar uma VM com telas virtuais ativadas.

Para criar uma VM com telas virtuais ativadas, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Criar uma instância.

Acesse "Criar uma instância"
Especifique as propriedades da VM, incluindo o nome, a zona e o tipo de máquina.
Na seção Dispositivo de exibição, marque a caixa de seleção Ativar dispositivo de exibição.
Para criar a VM, clique em Criar.

gcloud

Para criar uma VM com telas virtuais ativadas, use o comando gcloud compute instances create com a flag --enable-display-device.

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

Substitua:

VM_NAME: o nome da VM.
MACHINE_TYPE: o tipo de máquina a ser usado para a VM.
ZONE: a zona em que a instância de VM será criada.

Terraform

Para criar uma VM com telas virtuais ativadas, 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 telas virtuais ativadas 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 telas virtuais ativadas, faça uma solicitação POST para o método instances.insert. No corpo da solicitação, 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:

PROJECT_ID: o ID do projeto em que a VM será criada.
ZONE: a zona em que a instância de VM será criada.
VM_NAME: o nome da VM.
MACHINE_TYPE: o tipo de máquina a ser usado 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 imagem com suporte, consulte Imagens públicas.
IMAGE: especifique uma destas opções:
- Uma versão específica da imagem do SO, como debian-12-bookworm-v20240617.
- Uma família de imagens, que precisa ter o formato family/IMAGE_FAMILY. Ela especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, a versão mais recente na família de imagens do Debian 12 será usada. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.

Para mais informações sobre como criar uma VM, consulte Criar e iniciar uma instância do Compute Engine.

Ativar telas virtuais em uma VM

Antes de ativar as telas virtuais em uma VM, interrompa a VM.

Para ativar telas virtuais em uma VM, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Instâncias de VM.

Acessar a página "Instâncias de VM"
Na coluna Nome, clique no nome da VM.

A página de detalhes da VM é aberta.
Clique em Editar.

A página para editar as propriedades da VM é aberta.
Na seção Dispositivo de exibição, marque a caixa de seleção Ativar dispositivo de exibição.
Clique em Salvar.

gcloud

Para ativar telas virtuais em uma VM atual, use o comando gcloud compute instances update com a flag --enable-display-device.

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

Substitua:

VM_NAME: o nome da VM.
ZONE: a zona em que a VM está localizada.

REST

Para ativar telas virtuais em uma VM, faça uma solicitação POST para o método instances.updateDisplayDevice. No corpo da solicitação, 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:

PROJECT_ID: o ID do projeto em que a VM está.
ZONE: a zona em que a VM está.
VM_NAME: o nome da VM.

Desativar telas virtuais em uma VM existente

Antes de desativar as exibições virtuais em uma VM, interrompa a VM.

Para desativar as telas virtuais em uma VM, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Instâncias de VM.

Acessar a página "Instâncias de VM"
Na coluna Nome, clique no nome da VM.

A página de detalhes da VM é aberta.
Clique em Editar.

A página para editar as propriedades da VM é aberta.
Na seção Dispositivo de exibição, desmarque a caixa de seleção Ativar dispositivo de exibição.
Clique em Salvar.

gcloud

Para desativar telas virtuais em uma VM atual, 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:

VM_NAME: o nome da VM.
ZONE: a zona em que a VM está localizada.

REST

Para desativar as telas virtuais em uma VM, faça uma solicitação POST para o método instances.updateDisplayDevice. No corpo da solicitação, 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:

PROJECT_ID: o ID do projeto em que a VM está.
ZONE: a zona em que a VM está.
VM_NAME: o nome da VM.

Instale o driver de exibição virtual.

Se você tiver ativado telas virtuais em uma VM do Windows que executa uma imagem do SO Windows anterior à versão v20190312, para usar um dispositivo de exibição virtual na VM, será necessário instalar o driver de tela virtual fornecido por Google Cloud. Se a VM estiver executando uma versão mais recente da imagem do SO, o driver já estará instalado e você poderá pular esta seção.

Para instalar o driver de tela virtual em uma VM com telas virtuais ativadas, faça o seguinte:

Conecte-se à VM do Windows.
Abra um terminal do PowerShell como administrador.
Instale o componente google-compute-engine-driver-gga:
```
googet install google-compute-engine-driver-gga
```
Reinicie a VM.

Depois de reiniciar a VM, é possível verificar se o driver foi instalado corretamente, conforme descrito na próxima seção.

Verificar a instalação do driver de tela virtual

Se você precisou instalar manualmente o driver de tela virtual em uma VM do Windows, conforme descrito na seção anterior, siga estas etapas para verificar se a instalação foi concluída:

Conecte-se à VM do Windows, caso ainda não tenha feito isso.
Abra o Gerenciador de dispositivos.
Na lista Gerenciador de dispositivos, na lista Adaptadores de vídeo, verifique se o driver Google Graphics Array (GGA) está listado.

Se o driver não estiver listado, reinstale o driver de tela virtual, conforme descrito neste documento.

A seguir

Saiba como configurar a Área de trabalho remota do Google Chrome em VMs Linux.
Saiba como se conectar a VMs do Windows usando o protocolo RDP.

Ativar telas virtuais em uma VM Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Console

gcloud

Terraform

REST

Funções exigidas

Permissões necessárias

Preços

Restrições

Ativar telas virtuais em uma VM

Criar uma VM com telas virtuais ativadas.

Console

gcloud

Terraform

REST

Ativar telas virtuais em uma VM

Console

gcloud

REST

Desativar telas virtuais em uma VM existente

Console

gcloud

REST

Instale o driver de exibição virtual.

Verificar a instalação do driver de tela virtual

A seguir

Ativar telas virtuais em uma VM