Habilitar exibições virtuais em uma VM,Habilitar exibições virtuais em uma VM

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

Se um aplicativo em execução na sua VM exigir um dispositivo de exibição, mas você não precisar do desempenho de uma GPU, configure sua VM para usar dispositivos de exibição virtuais. Ao ativar exibições virtuais em uma VM, você pode executar dispositivos de exibição virtual na VM, como ferramentas de gerenciamento de sistema remoto, software de desktop remoto e captura de tela .

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  Terraform

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

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

     gcloud init

  4. 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, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.

  Confira mais informações em Set up authentication for a local development environment.

  REST

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

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Funções obrigatórias

Para obter as permissões necessárias para ativar ou desativar exibições virtuais em uma VM, peça ao administrador para conceder a você a função do IAM Compute Instance Admin (v1) ( roles/compute.instanceAdmin.v1 ) no projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Esta função predefinida contém as permissões necessárias para ativar ou desativar exibições virtuais em uma VM. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Preços

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

Restrições

Para VMs com monitores virtuais habilitados, aplicam-se as seguintes limitações:

• Se sua VM estiver executando uma imagem do sistema operacional Windows baseada em x64 anterior à versão v20190312 , depois de ativar exibições virtuais em sua VM, você deverá instalar o driver de exibição virtual conforme descrito neste documento. Se a sua VM estiver executando uma versão de imagem do sistema operacional mais recente, o driver já estará instalado na imagem do sistema operacional.

• Você poderá usar um dispositivo de exibição virtual na VM somente depois que o sistema operacional convidado inicializar e inicializar o driver de exibição virtual.

• Você não pode usar dispositivos de exibição virtual em VMs que executam a plataforma de CPU Sandy Bridge .

• Você não pode usar dispositivos de exibição virtual em VMs T2A Arm .

Habilitar exibições virtuais em uma VM

Para habilitar exibições virtuais em uma VM, selecione um dos seguintes métodos descritos neste documento:

• Crie uma VM com exibições virtuais habilitadas .

• Habilite exibições virtuais em uma VM existente .

Se sua VM estiver executando uma imagem do sistema operacional Windows baseada em x64 anterior à versão v20190312 , depois de habilitar exibições virtuais na VM, instale o driver de exibição virtual conforme descrito neste documento.

Crie uma VM com exibições virtuais habilitadas

Para criar uma VM com exibições virtuais habilitadas, selecione uma das seguintes opções:

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

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

Habilitar exibições virtuais em uma VM existente

Antes de ativar exibições virtuais em uma VM, certifique-se de interromper a VM .

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

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
}

Desabilitar exibições virtuais em uma VM existente

Antes de desabilitar exibições virtuais em uma VM, pare a VM .

Para desabilitar exibições virtuais em uma VM existente, selecione uma das seguintes opções:

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
}

Instale o driver de vídeo virtual

Se você tiver habilitado exibições virtuais em uma VM do Windows que executa uma imagem do sistema operacional Windows anterior à versão v20190312 , para usar um dispositivo de exibição virtual na VM, você deverá instalar o driver de exibição virtual fornecido por Google Cloud. Se a VM executar uma versão de imagem do sistema operacional mais recente, o driver já estará instalado e você poderá pular esta seção.

Para instalar o driver de vídeo virtual em uma VM com monitores virtuais habilitados, faça o seguinte:

1. Conecte-se à VM do Windows .

2. Abra um terminal 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, você poderá verificar se o driver foi instalado corretamente conforme descrito na próxima seção.

Verifique a instalação do driver de vídeo virtual

Se você teve que instalar manualmente o driver de vídeo virtual em uma VM do Windows conforme descrito na seção anterior, poderá verificar se a instalação foi bem-sucedida fazendo o seguinte:

1. Se ainda não o fez, conecte-se à VM do Windows .

2. Abra o Gerenciador de Dispositivos.

3. Na lista Gerenciador de dispositivos , na lista Adaptadores de vídeo , certifique-se de que o driver Google Graphics Array (GGA) esteja listado.

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

O que vem a seguir

• Saiba como configurar a Área de Trabalho Remota do Chrome em VMs Linux .

• Saiba como se conectar a VMs do Windows usando RDP .

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

Se um aplicativo em execução na sua VM exigir um dispositivo de exibição, mas você não precisar do desempenho de uma GPU, configure sua VM para usar dispositivos de exibição virtuais. Ao ativar exibições virtuais em uma VM, você pode executar dispositivos de exibição virtual na VM, como ferramentas de gerenciamento de sistema remoto, software de desktop remoto e captura de tela .

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  Terraform

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

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

     gcloud init

  4. 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, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.

  Confira mais informações em Set up authentication for a local development environment.

  REST

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

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Funções obrigatórias

Para obter as permissões necessárias para ativar ou desativar exibições virtuais em uma VM, peça ao administrador para conceder a você a função do IAM Compute Instance Admin (v1) ( roles/compute.instanceAdmin.v1 ) no projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Esta função predefinida contém as permissões necessárias para ativar ou desativar exibições virtuais em uma VM. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Preços

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

Restrições

Para VMs com monitores virtuais habilitados, aplicam-se as seguintes limitações:

• Se sua VM estiver executando uma imagem do sistema operacional Windows baseada em x64 anterior à versão v20190312 , depois de ativar exibições virtuais em sua VM, você deverá instalar o driver de exibição virtual conforme descrito neste documento. Se a sua VM estiver executando uma versão de imagem do sistema operacional mais recente, o driver já estará instalado na imagem do sistema operacional.

• Você poderá usar um dispositivo de exibição virtual na VM somente depois que o sistema operacional convidado inicializar e inicializar o driver de exibição virtual.

• Você não pode usar dispositivos de exibição virtual em VMs que executam a plataforma de CPU Sandy Bridge .

• Você não pode usar dispositivos de exibição virtual em VMs T2A Arm .

Habilitar exibições virtuais em uma VM

Para habilitar exibições virtuais em uma VM, selecione um dos seguintes métodos descritos neste documento:

• Crie uma VM com exibições virtuais habilitadas .

• Habilite exibições virtuais em uma VM existente .

Se sua VM estiver executando uma imagem do sistema operacional Windows baseada em x64 anterior à versão v20190312 , depois de habilitar exibições virtuais na VM, instale o driver de exibição virtual conforme descrito neste documento.

Crie uma VM com exibições virtuais habilitadas

Para criar uma VM com exibições virtuais habilitadas, selecione uma das seguintes opções:

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

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

Habilitar exibições virtuais em uma VM existente

Antes de ativar exibições virtuais em uma VM, certifique-se de interromper a VM .

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

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
}

Desabilitar exibições virtuais em uma VM existente

Antes de desabilitar exibições virtuais em uma VM, pare a VM .

Para desabilitar exibições virtuais em uma VM existente, selecione uma das seguintes opções:

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
}

Instale o driver de vídeo virtual

Se você tiver habilitado exibições virtuais em uma VM do Windows que executa uma imagem do sistema operacional Windows anterior à versão v20190312 , para usar um dispositivo de exibição virtual na VM, você deverá instalar o driver de exibição virtual fornecido por Google Cloud. Se a VM executar uma versão de imagem do sistema operacional mais recente, o driver já estará instalado e você poderá pular esta seção.

Para instalar o driver de vídeo virtual em uma VM com monitores virtuais habilitados, faça o seguinte:

1. Conecte-se à VM do Windows .

2. Abra um terminal 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, você poderá verificar se o driver foi instalado corretamente conforme descrito na próxima seção.

Verifique a instalação do driver de vídeo virtual

Se você teve que instalar manualmente o driver de vídeo virtual em uma VM do Windows conforme descrito na seção anterior, poderá verificar se a instalação foi bem-sucedida fazendo o seguinte:

1. Se ainda não o fez, conecte-se à VM do Windows .

2. Abra o Gerenciador de Dispositivos.

3. Na lista Gerenciador de dispositivos , na lista Adaptadores de vídeo , certifique-se de que o driver Google Graphics Array (GGA) esteja listado.

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

O que vem a seguir

• Saiba como configurar a Área de Trabalho Remota do Chrome em VMs Linux .

• Saiba como se conectar a VMs do Windows usando RDP .