Attivare i display virtuali su una VM

Linux Windows

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

Se un'applicazione in esecuzione sulla tua VM richiede un dispositivo di visualizzazione, ma non hai bisogno delle prestazioni di una GPU, configura la VM in modo che utilizzi display virtuali. Se attivi i display virtuali su una VM, puoi eseguire dispositivi di visualizzazione virtuali sulla VM, come strumenti di gestione del sistema remoto, software di desktop remoto e acquisizione schermo.

Prima di iniziare

Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:
Console

Quando utilizzi la console Google Cloud per accedere ai servizi Google Cloud e alle API, non devi configurare l'autenticazione.
gcloud
1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:
  gcloud init
  Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
  
  Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
Imposta una regione e una zona predefinite.

Terraform

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

Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
Se utilizzi una shell locale, crea credenziali di autenticazione locali per il tuo account utente:
```
gcloud auth application-default login
```
Non è necessario eseguire questa operazione se utilizzi Cloud Shell.

Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

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.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per attivare o disattivare i display virtuali su una VM, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per attivare o disattivare i display virtuali su una VM. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per attivare o disattivare i display virtuali su una VM sono necessarie le seguenti autorizzazioni:

Per attivare o disattivare i display virtuali su una VM esistente: compute.instances.updateDisplayDevice sulla VM
Per creare una VM con i display virtuali abilitati:
- compute.instances.create sul progetto
- Per utilizzare un'immagine personalizzata per creare la VM&colon; compute.images.useReadOnly sull'immagine
- Per utilizzare uno snapshot per creare la VM&colon; compute.snapshots.useReadOnly sullo snapshot
- Per utilizzare un template di istanza per creare la VM&colon; compute.instanceTemplates.useReadOnly sul template di istanza
- Per assegnare una rete legacy alla VM&colon; compute.networks.use sul progetto
- Per specificare un indirizzo IP statico per la VM&colon; compute.addresses.use sul progetto
- Per assegnare un indirizzo IP esterno alla VM quando viene utilizzata una rete legacy&colon; compute.networks.useExternalIp sul progetto
- Per specificare una subnet per la VM&colon; compute.subnetworks.use sul progetto o sulla subnet scelta
- Per assegnare un indirizzo IP esterno alla VM quando viene utilizzata una rete VPC&colon; compute.subnetworks.useExternalIp sul progetto o sulla subnet scelta
- Per impostare i metadati dell'istanza VM per la VM&colon; compute.instances.setMetadata sul progetto
- Per impostare i tag per la VM&colon; compute.instances.setTags sulla VM
- Per impostare le etichette per la VM&colon; compute.instances.setLabels sulla VM
- Per impostare un service account da utilizzare per la VM&colon; compute.instances.setServiceAccount sulla VM
- Per creare un nuovo disco per la VM&colon; compute.disks.create sul progetto
- Per collegare un disco esistente in modalità di sola lettura o lettura/scrittura&colon; compute.disks.use sul disco
- Per collegare un disco esistente in modalità di sola lettura&colon; compute.disks.useReadOnly sul disco

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Prezzi

Non sono previsti costi per l'attivazione o la disattivazione dei display virtuali su una VM.

Limitazioni

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

Se la tua VM esegue un'immagine del sistema operativo Windows basata su x64 precedente alla versione v20190312, dopo aver attivato i display virtuali sulla VM, devi installare il driver del display virtuale come descritto in questo documento. Se la VM esegue una versione successiva dell'immagine sistema operativo, il driver è già installato sull'immagine sistema operativo.
Puoi utilizzare un dispositivo di visualizzazione virtuale sulla VM solo dopo l'avvio del sistema operativo guest e l'inizializzazione del driver di visualizzazione virtuale.
Non puoi utilizzare dispositivi di visualizzazione virtuali sulle VM che eseguono la piattaforma CPU Sandy Bridge.
Non puoi utilizzare dispositivi di visualizzazione virtuali su VM T2A Arm.

Attiva i display virtuali su una VM

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

Crea una VM con i display virtuali abilitati.
Attiva i display virtuali su una VM esistente.

Se la tua VM esegue un'immagine del sistema operativo Windows basata su x64 precedente alla versione v20190312, dopo aver attivato i display virtuali sulla VM, installa il driver del display virtuale come descritto in questo documento.

Crea una VM con i display virtuali abilitati

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

Console

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

Vai a Crea un'istanza
Specifica le proprietà della VM, inclusi nome, zona e tipo di macchina.
Nella sezione Dispositivo di visualizzazione, seleziona la casella di controllo Abilita dispositivo di visualizzazione.
Per creare la VM, fai clic su Crea.

gcloud

Per creare una VM con i display virtuali attivati, utilizza il 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: il tipo di macchina da utilizzare per la VM.
ZONE: la zona in cui creare la VM.

Terraform

Per creare una VM con i display virtuali attivati, utilizza la risorsa Terraform con l'argomento enable_display impostato su true.

Ad esempio, per creare una VM nella zona us-central1-c con i display virtuali attivati e specificare f1-micro come tipo di macchina, utilizza la seguente 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 i display virtuali abilitati, invia una richiesta POST al 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: il tipo di macchina da utilizzare per la VM.
IMAGE_PROJECT: il progetto di immagini che contiene l'immagine sistema operativo, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, consulta Immagini pubbliche.
IMAGE: specifica una delle seguenti opzioni:
- Una versione specifica dell'immagine sistema operativo, ad esempio debian-12-bookworm-v20240617.
- Una famiglia di immagini, che deve essere formattata come family/IMAGE_FAMILY. In questo modo, viene specificata l'immagine sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per saperne di più sull'utilizzo delle famiglie di immagini, consulta le best practice per le famiglie di immagini.

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

Attiva i display virtuali su una VM esistente

Prima di attivare i display virtuali su una VM, assicurati di arrestarla.

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

Console

Nella console Google Cloud , vai alla pagina Istanze VM.

Vai alla pagina Istanze VM
Nella colonna Nome, fai clic sul nome della VM.

Viene visualizzata la pagina dei dettagli della VM.
Fai clic su Modifica.

Viene visualizzata la pagina per modificare le proprietà della VM.
Nella sezione Dispositivo di visualizzazione, seleziona la casella di controllo Abilita dispositivo di visualizzazione.
Fai clic su Salva.

gcloud

Per attivare i display virtuali su una VM esistente, utilizza il 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 attivare i display virtuali su una VM esistente, invia una richiesta POST al 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.
ZONE: la zona in cui si trova la VM.
VM_NAME: il nome della VM.

Disattiva i display virtuali su una VM esistente

Prima di disattivare i display virtuali su una VM, assicurati di arrestare la VM.

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

Console

Nella console Google Cloud , vai alla pagina Istanze VM.

Vai alla pagina Istanze VM
Nella colonna Nome, fai clic sul nome della VM.

Viene visualizzata la pagina dei dettagli della VM.
Fai clic su Modifica.

Viene visualizzata la pagina per modificare le proprietà della VM.
Nella sezione Dispositivo di visualizzazione, deseleziona la casella di controllo Abilita dispositivo di visualizzazione.
Fai clic su Salva.

gcloud

Per disattivare i display virtuali su una VM esistente, utilizza il 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 disattivare i display virtuali su una VM esistente, invia una richiesta POST al 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.
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 precedente alla versione v20190312, per utilizzare un dispositivo di visualizzazione virtuale sulla VM, devi installare il driver di visualizzazione virtuale fornito da Google Cloud. Se la VM esegue una versione più recente dell'immagine del sistema operativo, il driver è già installato e puoi saltare questa sezione.

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

Connettiti alla VM Windows.
Apri un terminale PowerShell come amministratore.
Installa il componente google-compute-engine-driver-gga:
```
googet install google-compute-engine-driver-gga
```
Riavvia la VM.

Dopo aver riavviato la VM, puoi verificare che il driver sia stato installato correttamente come descritto nella sezione successiva.

Verifica l'installazione del driver di visualizzazione virtuale

Se hai dovuto installare manualmente il driver di visualizzazione virtuale su una VM Windows come descritto nella sezione precedente, puoi verificare che l'installazione sia riuscita procedendo nel seguente modo:

Se non l'hai ancora fatto, connettiti alla VM Windows.
Apri Gestione dispositivi.
Nell'elenco Gestione dispositivi, nell'elenco Schede video, assicurati che sia elencato il driver Google Graphics Array (GGA).

Se il driver non è elencato, reinstalla il driver dello schermo virtuale come descritto in questo documento.

Passaggi successivi

Scopri come configurare Chrome Remote Desktop sulle VM Linux.
Scopri come connetterti alle VM Windows utilizzando RDP.

Attivare i display virtuali su una VM Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Console

gcloud

Terraform

REST

Ruoli obbligatori

Autorizzazioni obbligatorie

Prezzi

Limitazioni

Attiva i display virtuali su una VM

Crea una VM con i display virtuali abilitati

Console

gcloud

Terraform

REST

Attiva i display virtuali su una VM esistente

Console

gcloud

REST

Disattiva i display virtuali su una VM esistente

Console

gcloud

REST

Installa il driver del display virtuale

Verifica l'installazione del driver di visualizzazione virtuale

Passaggi successivi

Attivare i display virtuali su una VM