Abilita display virtuali su una VM

Questo documento descrive come attivare o disattivare i display virtuali su una macchina di una macchina virtuale (VM).

Se un'applicazione in esecuzione sulla VM richiede un dispositivo di visualizzazione, ma che necessitano delle prestazioni di una GPU, quindi configura la VM per l'uso del display virtuale dispositivi mobili. Se abiliti le visualizzazioni virtuali su una VM, puoi eseguire dispositivi sulla VM, come strumenti di gestione remota del sistema, desktop software e acquisizione schermo.

Prima di iniziare

  • Se non l'hai già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

    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. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

      gcloud init
    2. Set a default region and zone.
    3. Terraform

      Per utilizzare gli esempi di Terraform in questa pagina in un ambiente dell'ambiente di sviluppo, installare e inizializzare gcloud CLI quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

      1. Installa Google Cloud CLI.
      2. Per initialize gcloud CLI, esegui questo comando:

        gcloud init
      3. Crea credenziali di autenticazione locali per il tuo Account Google:

        gcloud auth application-default login

      Per ulteriori informazioni, vedi Set up authentication for a local development environment.

      REST

      Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per abilitare o disabilitare le visualizzazioni virtuali su una VM, chiedi all'amministratore di concederti Ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per abilitare o disabilitare le visualizzazioni virtuali su una VM. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per abilitare o disabilitare le visualizzazioni virtuali su una VM sono necessarie le seguenti autorizzazioni:

  • Per attivare o disattivare le visualizzazioni virtuali su una VM esistente: compute.instances.updateDisplayDevice sulla VM
  • Per creare una VM con display virtuali abilitati:
    • compute.instances.create nel progetto
    • Per utilizzare un'immagine personalizzata per creare la VM: compute.images.useReadOnly sull'immagine
    • Per utilizzare uno snapshot per creare la VM: compute.snapshots.useReadOnly nello snapshot
    • Per utilizzare un modello di istanza per creare la VM: compute.instanceTemplates.useReadOnly nel modello di istanza
    • Per assegnare una rete legacy alla VM,: compute.networks.use nel progetto
    • Per specificare un indirizzo IP statico per la VM: compute.addresses.use nel progetto
    • Per assegnare un indirizzo IP esterno alla VM quando utilizzi una rete legacy: compute.networks.useExternalIp nel progetto
    • Per specificare una subnet per la VM: compute.subnetworks.use nel progetto o nella subnet scelta
    • Per assegnare un indirizzo IP esterno alla VM quando utilizzi una rete VPC,: compute.subnetworks.useExternalIp nel progetto o nella subnet scelta
    • Per impostare i metadati dell'istanza VM per la VM: compute.instances.setMetadata nel progetto
    • Per impostare i tag per la VM: compute.instances.setTags sulla VM
    • Per impostare le etichette per la VM: compute.instances.setLabels sulla VM
    • Per impostare un account di servizio che la VM deve utilizzare: compute.instances.setServiceAccount sulla VM
    • Per creare un nuovo disco per la VM: compute.disks.create nel progetto
    • Per collegare un disco esistente in modalità di sola lettura o lettura/scrittura: compute.disks.use sul disco
    • Per collegare un disco esistente in modalità di sola lettura: compute.disks.useReadOnly sul disco

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

Prezzi

Non sono previsti costi associati all'attivazione o alla disattivazione di display virtuali su VM.

Limitazioni

Per le VM con display virtuali abilitati, si applicano le seguenti limitazioni:

  • Se la VM esegue un'immagine del sistema operativo Windows basata su x64 precedente alla versione v20190312, poi, dopo aver abilitato i display virtuali sulla tua VM, devi installare il driver del display virtuale come descritto in documento. Se la VM esegue una versione dell'immagine del sistema operativo successiva, il driver è già installata nell'immagine sistema operativo.

  • Puoi utilizzare un dispositivo di visualizzazione virtuale sulla VM solo dopo l'avvio del sistema operativo guest e inizializza il driver del display virtuale.

  • Non puoi utilizzare i dispositivi di visualizzazione virtuali sulle VM che eseguono Piattaforma CPU Sandy Bridge.

  • Non puoi utilizzare display virtuali su VM ARM T2A.

Abilita display virtuali su una VM

Per abilitare i display virtuali su una VM, seleziona uno dei seguenti metodi descritti in questo documento:

Se la VM esegue un'immagine del sistema operativo Windows basata su x64 precedente alla versione v20190312, poi, dopo aver abilitato le visualizzazioni virtuali sulla VM, installare il driver del display virtuale come descritto in documento.

Crea una VM con display virtuali abilitati

Per creare una VM con display virtuali abilitati, seleziona una delle seguenti opzioni opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Crea un'istanza.

    Vai a Crea un'istanza

  2. Specifica le proprietà della VM, inclusi nome, zona e macchina di testo.

  3. Nella sezione Dispositivo di visualizzazione, seleziona Attiva dispositivo di visualizzazione. casella di controllo.

  4. Per creare la VM, fai clic su Crea.

gcloud

Per creare una VM con display virtuali abilitati, utilizza la Comando gcloud compute instances create con il flag --enable-display-device.

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

Sostituisci quanto segue:

  • VM_NAME: il nome della VM.

  • MACHINE_TYPE: tipo di macchina da utilizzare per la VM.

  • ZONE: la zona in cui creare la VM.

Terraform

Per creare una VM con display virtuali abilitati, utilizza la Risorsa Terraform con l'argomento enable_display impostato su true.

Ad esempio, per creare una VM nella zona us-central1-c con display virtuali e specifica f1-micro come tipo di macchina, usa quanto segue risorsa:


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

Per creare una VM con display virtuali abilitati, effettua una richiesta POST alla Metodo instances.insert. Nel corpo della richiesta, includi il campo enableDisplay impostato su 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"
    }
  ]
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui creare la VM.

  • ZONE: la zona in cui creare la VM.

  • VM_NAME: il nome della VM.

  • MACHINE_TYPE: tipo di macchina da utilizzare per la VM.

  • IMAGE_PROJECT: il progetto immagine che contiene il sistema operativo immagine, ad esempio debian-cloud. Per ulteriori informazioni sui per i progetti immagine supportati, consulta Immagini pubbliche.

  • IMAGE: specifica una delle seguenti opzioni:

    • Una versione specifica dell'immagine del sistema operativo, ad esempio debian-12-bookworm-v20240617.

    • Una famiglia di immagini, che deve essere formattato come family/IMAGE_FAMILY. Questo specifica l'immagine del sistema operativo più recente e non deprecata. Ad esempio, se specifica family/debian-12, la versione più recente in Debian 12 famiglia di immagini. Per ulteriori informazioni sull'utilizzo delle immagini le famiglie, vedi Best practice per le famiglie di immagini.

Per saperne di più sulla creazione di una VM, consulta Crea e avvia un'istanza Compute Engine.

Abilita display virtuali su una VM esistente

Prima di abilitare i display virtuali su una VM, assicurati di interrompere la VM.

Per abilitare i display virtuali su una VM esistente, seleziona una delle seguenti opzioni opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Istanze VM.

    Vai alla pagina Istanze VM

  2. Nella colonna Nome, fai clic sul nome della VM.

    Si apre la pagina dei dettagli della VM.

  3. Fai clic su Modifica.

    Si apre la pagina per modificare le proprietà della VM.

  4. Nella sezione Dispositivo di visualizzazione, seleziona Attiva dispositivo di visualizzazione. casella di controllo.

  5. Fai clic su Salva.

gcloud

Per abilitare i display virtuali su una VM esistente, utilizza Comando gcloud compute instances update con il flag --enable-display-device.

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

Sostituisci quanto segue:

  • VM_NAME: il nome della VM.

  • ZONE: la zona in cui si trova la VM.

REST

Per abilitare i display virtuali su una VM esistente, effettua una richiesta POST alla Metodo instances.updateDisplayDevice. Nel corpo della richiesta, includi il campo enableDisplay e impostalo su true.

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

{
  "enableDisplay": true
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la VM individuarlo.

  • ZONE: la zona in cui si trova la VM.

  • VM_NAME: il nome della VM.

Disabilita display virtuali su una VM esistente

Prima di disabilitare le visualizzazioni virtuali su una VM, assicurati di interrompere la VM.

Per disabilitare le visualizzazioni virtuali su una VM esistente, seleziona una delle seguenti opzioni opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Istanze VM.

    Vai alla pagina Istanze VM

  2. Nella colonna Nome, fai clic sul nome della VM.

    Si apre la pagina dei dettagli della VM.

  3. Fai clic su Modifica.

    Si apre la pagina per modificare le proprietà della VM.

  4. Nella sezione Dispositivo di visualizzazione, deseleziona Attiva dispositivo di visualizzazione. casella di controllo.

  5. Fai clic su Salva.

gcloud

Per disabilitare le visualizzazioni virtuali su una VM esistente, utilizza la Comando gcloud compute instances update con il flag --no-enable-display-device.

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

Sostituisci quanto segue:

  • VM_NAME: il nome della VM.

  • ZONE: la zona in cui si trova la VM.

REST

Per disabilitare le visualizzazioni virtuali su una VM esistente, effettua una richiesta POST alla Metodo instances.updateDisplayDevice. Nel corpo della richiesta, includi il campo enableDisplay e impostalo su false.

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

{
  "enableDisplay": false
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la VM individuarlo.

  • ZONE: la zona in cui si trova la VM.

  • VM_NAME: il nome della VM.

Installa il driver del display virtuale

Se hai abilitato i display virtuali su una VM Windows che esegue un'immagine del sistema operativo Windows prima della versione v20190312, per utilizzare un display virtuale sulla VM, devi installare il driver del display virtuale fornito da Google Cloud. Se La VM esegue una versione più recente dell'immagine del sistema operativo, quindi il driver è già installato puoi saltare questa sezione.

Per installare il driver del display virtuale su una VM con display virtuali abilitati, procedi nel seguente modo: le seguenti:

  1. Connettiti alla VM Windows.

  2. Apri un terminale PowerShell come amministratore.

  3. Installa il componente google-compute-engine-driver-gga:

    googet install google-compute-engine-driver-gga
    
  4. Riavvia la VM.

Dopo aver riavviato la VM, puoi verifica che il driver sia stato installato correttamente come descritti nella prossima sezione.

Verificare l'installazione del driver del display virtuale

Se devi installare manualmente il driver del display virtuale sul una VM Windows, come descritto nella sezione precedente, puoi verificare che l'installazione è riuscita procedendo nel seguente modo:

  1. Se non l'hai già fatto, connetterti alla VM Windows.

  2. Apri Gestione dispositivi.

  3. Nell'elenco Gestione dispositivi, nell'elenco Adattatori display, assicurati che compare il driver di Google Graphics Array (GGA).

    Se il conducente non è nell'elenco, reinstalla il driver del display virtuale come descritto in documento.

Passaggi successivi