Activer les affichages virtuels

Linux Windows

---

Si les applications sur vos instances de VM nécessitent un appareil d'affichage, mais n'ont pas besoin de toute la puissance d'un GPU, vous pouvez configurer vos instances avec un appareil d'affichage virtuel. Il vous permettra d'exécuter des outils de gestion du système et des logiciels de bureau à distance qui requièrent un appareil d'affichage.

Configurez un appareil d'affichage virtuel lorsque vous créez une instance ou ajoutez-en un à une instance existante pendant qu'elle est arrêtée. L'activation de vos instances avec un appareil d'affichage virtuel est gratuite.

Avant de commencer

• Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :
  

  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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  Terraform

  Pour utiliser les exemples Terraform de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.

  1. Install the Google Cloud CLI.

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

     gcloud init

  3. 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.

  Pour en savoir plus, consultez Set up authentication for a local development environment.

  REST

  Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier les affichages virtuels sur une VM, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient les autorisations requises pour modifier les affichages virtuels sur une VM. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour modifier les affichages virtuels sur une VM :

• Pour ajouter ou supprimer un affichage virtuel sur une VM existante : compute.instances.updateDisplayDevice sur la VM
• Pour créer une VM avec un appareil d'affichage virtuel :
  • compute.instances.create sur le projet
  • Pour créer la VM à l'aide d'une image personnalisée : compute.images.useReadOnly sur l'image
  • Pour créer la VM à l'aide d'un instantané : compute.snapshots.useReadOnly sur l'instantané
  • Pour créer la VM à l'aide d'un modèle d'instance : compute.instanceTemplates.useReadOnly sur le modèle d'instance
  • Pour attribuer un ancien réseau à la VM : compute.networks.use sur le projet
  • Pour spécifier une adresse IP statique pour la VM : compute.addresses.use sur le projet
  • Pour attribuer une adresse IP externe à la VM, en cas d'utilisation d'un ancien réseau : compute.networks.useExternalIp sur le projet
  • Pour spécifier un sous-réseau pour la VM : compute.subnetworks.use sur le projet ou sur le sous-réseau choisi
  • Pour attribuer une adresse IP externe à la VM, en cas d'utilisation d'un réseau VPC : compute.subnetworks.useExternalIp sur le projet ou sur le sous-réseau choisi
  • Pour définir les métadonnées d'instance de VM pour la VM : compute.instances.setMetadata sur le projet
  • Pour définir des tags pour la VM : compute.instances.setTags sur la VM
  • Pour définir des libellés pour la VM : compute.instances.setLabels sur la VM
  • Pour définir un compte de service à utiliser avec la VM : compute.instances.setServiceAccount sur la VM
  • Pour créer un disque pour la VM : compute.disks.create sur le projet
  • Pour associer un disque existant en mode lecture seule ou en mode lecture-écriture : compute.disks.use sur le disque
  • Pour associer un disque existant en mode lecture seule : compute.disks.useReadOnly sur le disque

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Restrictions

• Google est compatible avec les appareils d'affichage virtuels sur les instances Linux et sur les instances Windows utilisant des images Windows à base x64 v20190312 ou versions ultérieures.
• Si votre instance de VM exécute une image Windows antérieure à la version v20190312, vous devez également installer manuellement le pilote d'appareil une fois les appareils d'affichage virtuels activés sur l'instance. Les pilotes d'appareil sont préinstallés sur les images disponibles à partir de la version v20190312.
• Les appareils d'affichage virtuels ne fonctionnent que lorsque le système d'exploitation invité a démarré et initialisé le pilote d'affichage virtuel. Vous ne pouvez pas utiliser d'appareils d'affichage virtuels pendant le test POST ou pendant le démarrage du système d'exploitation invité.
• Les appareils d'affichage virtuels ne sont pas compatibles avec les instances exécutant la plate-forme de processeur Sandy Bridge.
• Les appareils d'affichage virtuels ne sont pas compatibles avec les VM T2A Arm.

Créer une instance avec un appareil d'affichage virtuel

Vous pouvez activer un appareil d'affichage virtuel sur une instance lors de sa création. Vous pouvez également ajouter un appareil d'affichage virtuel à une instance existante.

Console

1. Accédez à la page Créer une instance dans Google Cloud Console.

   Accéder à la page Créer une instance

2. Définissez les propriétés de la VM, y compris le nom, la région, la zone et la configuration de la machine.

3. Pour activer l'appareil d'affichage virtuel, accédez aux réglages Configuration de la machine > Appareil d'affichage et cochez la case Activer l'appareil d'affichage.

   L'appareil d'affichage virtuel vous permet d'utiliser la capture d'écran.

4. Pour créer la VM, cliquez sur Créer.

gcloud

Dans Google Cloud CLI, exécutez la commande compute instances create en incluant l'option --enable-display-device :

 gcloud compute instances create [INSTANCE_NAME] --enable-display-device

où [INSTANCE_NAME] est le nom de l'instance que vous souhaitez créer.

Terraform

Vous pouvez utiliser la ressource Terraform pour créer une instance avec l'affichage virtuel activé en définissant l'argument enable_display sur true.

compute/instance_virtual_display_enabled/main.tf

Afficher sur GitHub Commentaires

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

Dans l'API, envoyez une requête POST à la méthode compute.instances.insert. Dans le corps de la requête, incluez les propriétés de l'instance ainsi que la propriété displayDevice avec l'option enableDisplay définie sur true.

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances

{
  "name": "[INSTANCE_NAME]",
  "machineType": "zones/[ZONE]/machineTypes/[MACHINE_TYPE]",
  "displayDevice": {
    "enableDisplay": true
  },
⋮
}]

où :

• [INSTANCE_NAME] est le nom de l'instance.
• [PROJECT_ID] est l'ID de votre projet.
• [ZONE] est la zone où se situe votre instance.

Une fois que vous avez créé une instance avec un appareil d'affichage virtuel, vous pouvez configurer un bureau à distance pour gérer à distance votre instance Windows.

Ajouter ou supprimer un appareil d'affichage virtuel sur une instance existante

Vous pouvez activer un appareil d'affichage virtuel sur une instance existante. Vous pouvez également activer un appareil d'affichage virtuel lorsque vous créez une instance.

Avant de pouvoir activer ou désactiver un appareil d'affichage virtuel sur une instance en cours d'exécution, vous devez arrêter l'instance.

Console

1. Accédez à la page Instances de VM.

   Accéder à la page "Instances de VM"

2. Dans la colonne Nom, cliquez sur le nom de l'instance dans laquelle vous souhaitez ajouter ou supprimer l'appareil d'affichage virtuel.

3. En haut de la page Détails de l'instance de VM, cliquez sur Arrêter.

4. En haut de la page Détails de l'instance de VM, cliquez sur Modifier.

5. Sous Appareil d'affichage, cliquez sur Activer l'appareil d'affichage pour activer ou désactiver l'appareil d'affichage virtuel pour cette instance.

6. En bas des paramètres de création de l'instance, cliquez sur Enregistrer.

gcloud

Pour ajouter un appareil d'affichage virtuel, utilisez la commande compute instances update dans Google Cloud CLI en incluant l'option --enable-display-device :

 gcloud compute instances update [INSTANCE_NAME] --enable-display-device

où [INSTANCE_NAME] est le nom de l'instance que vous souhaitez créer.

Pour supprimer un appareil d'affichage virtuel, utilisez la commande compute instances update dans gcloud CLI en incluant l'option --no-enable-display-device :

 gcloud compute instances update [INSTANCE_NAME] --no-enable-display-device

où [INSTANCE_NAME] est le nom de l'instance que vous souhaitez créer.

REST

Dans l'API, envoyez une requête POST à la méthode compute.instances.updateDisplayDevice. Dans le corps de la requête, incluez la propriété enableDisplay. Pour activer l'appareil d'affichage virtuel sur cette instance, définissez l'option enableDisplay sur true. Pour désactiver l'appareil d'affichage virtuel sur l'instance, définissez l'option enableDisplay sur false.

POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]/updateDisplayDevice

{
 "enableDisplay": [ENABLE_DISPLAY]
}

où :

• [INSTANCE_NAME] est le nom de l'instance sur laquelle vous souhaitez activer ou désactiver l'appareil d'affichage virtuel.
• [PROJECT_ID] est l'ID de votre projet.
• [ZONE] est la zone où se situe votre instance.
• [ENABLE_DISPLAY] vaut soit true pour activer l'appareil d'affichage virtuel sur l'instance, soit false pour le désactiver.

Une fois que vous avez créé une instance avec un appareil d'affichage virtuel, vous pouvez configurer un bureau à distance pour gérer à distance votre instance Windows.

Installer le pilote d'affichage virtuel

Google fournit un pilote d'affichage qui permet aux instances Windows d'utiliser correctement les appareils d'affichage virtuels. Le pilote est requis pour plusieurs fonctionnalités de Compute Engine. Ce pilote d'affichage fourni par Google n'est destiné qu'aux instances Windows.

Remarque : L'installation de ce pilote n'est requise que pour les VM exécutant des images Windows antérieures à la version v20190312. Les pilotes d'appareil sont préinstallés sur les images plus récentes.

Une fois que vous avez créé une instance avec un appareil d'affichage virtuel ou ajouté un appareil d'affichage virtuel à une instance existante, vous pouvez installer l'appareil d'affichage virtuel sur l'instance en procédant comme suit :

1. Connectez-vous à l'instance Windows où l'appareil d'affichage virtuel est activé.
2. Ouvrez un terminal PowerShell en tant qu'administrateur.

3. Exécutez le programme d'installation googet pour installer le composant google-compute-engine-driver-gga :

   googet install google-compute-engine-driver-gga
   

4. Redémarrez l'instance.

Après avoir redémarré l'instance, vérifiez que le pilote a été installé en suivant les instructions ci-dessous.

Vérifier l'installation du pilote d'affichage virtuel

Si vous avez dû installer manuellement le pilote d'appareil, suivez les instructions ci-dessous pour vérifier que l'installation a réussi.

1. Connectez-vous à l'instance Windows où l'appareil d'affichage virtuel est activé.
2. Ouvrez l'outil Exécuter et exécutez l'outil de gestion de l'ordinateur devmgmt.msc.
3. Dans la barre de navigation de l'outil de gestion de l'ordinateur, cliquez sur Device Manager (Gestionnaire d'appareils) pour afficher la liste des appareils.
4. Vérifiez que le pilote Google Graphics Array est répertorié dans la liste Display adapters (cartes graphiques).
5. Si la carte vidéo de base Microsoft (Microsoft Basic Display) est répertoriée en tant que carte graphique au lieu du pilote Google Graphics Array, répétez le processus d'installation du pilote et vérifiez à nouveau.

Étape suivante

• Consultez le tutoriel Configurer le service Bureau à distance Chrome pour Linux sur Compute Engine.
• Documentez-vous sur les différentes méthodes de connexion aux instances Windows.
• Découvrez comment arrêter et démarrer une instance.