Environnement invité

Ce document présente l'environnement invité, qui contient les scripts, les daemons et les binaires dont les instances ont besoin pour s'exécuter sur Compute Engine.

L'environnement invité communique avec le serveur de métadonnées, qui est un serveur HTTP par instance qui s'exécute en parallèle de chaque instance Compute Engine. Le serveur de métadonnées fournit à l'instance des données de configuration et opérationnelles essentielles. Pour en savoir plus sur les types de métadonnées stockées sur le serveur de métadonnées, consultez Métadonnées de VM.

L'environnement invité est automatiquement installé sur les instances Compute Engine créées à l'aide de la plupart des images de système d'exploitation (OS) publiques fournies par Google. Chaque image d'OS nécessite des packages d'environnement invité spécifiques. Ces packages sont créés par Google ou par le distributeur du système d'exploitation. Les mises à jour des packages de l'environnement invité sont déployées région par région. Le déploiement de ces modifications dans tous les établissements du monde peut prendre jusqu'à deux semaines. Pour en savoir plus, consultez Déploiements du dépôt de packages de l'environnement invité.

Pour obtenir la liste complète des images d'OS incluant l'environnement invité, consultez Détails des systèmes d'exploitation.

Composants de l'environnement invité

La section suivante décrit les packages et les services qui permettent à une instance de communiquer avec Compute Engine.

L'agent invité

L'agent invité est le composant central de l'environnement invité. Il gère des tâches telles que la gestion des comptes, l'intégration d'OS Login et la gestion des interfaces réseau. L'agent invité est disponible pour les systèmes d'exploitation Linux et Windows, avec les noms de packages suivants :

  • Linux : google-guest-agent
  • Windows : google-compute-engine-windows

Pour en savoir plus sur l'agent invité, y compris sur ses fonctionnalités, son architecture et sa gestion, consultez Agent invité.

Composants Linux

Les composants de base d'un environnement invité Linux sont des packages deb ou rpm. Compute Engine crée ces packages avec les configurations appropriées pour la distribution compatible. Pour afficher la liste des packages installés sur votre instance Linux, connectez-vous à l'instance et exécutez la commande fournie pour votre version d'OS dans le tableau Packages installés par version du système d'exploitation.

L'environnement invité Linux inclut les packages clés suivants.

Nom du package Description Interactions clés Lien vers le code source sur GitHub
google-guest-agent

Ce package est l'agent invité pour l'environnement Linux.

L'agent invité Linux contient les scripts qui s'exécutent sur le système d'exploitation invité pour assurer la compatibilité avec les fonctionnalités de Compute Engine. Pour en savoir plus sur l'agent invité, y compris sur ses fonctionnalités, son architecture et sa gestion, consultez Agent invité.

 guest-agent
google-compute-engine

Contient les scripts et les fichiers requis pour l'initialisation et la configuration du système.

Ce package contient les éléments suivants :

  • Scripts d'initialisation système pour systemd
  • Configurations système, telles que les règles udev et sysctl, et les configurations rsyslog et dhcp, utilisées pour définir le nom d'hôte
  • Scripts Bash exécutés au démarrage de l'instance
  • Fichier gce-resolved.conf, introduit en octobre 2024, qui garantit que les recherches de domaine pour les domaines Cloud DNS .local sont acheminées vers le serveur de métadonnées. Sans ce fichier, les recherches de domaine sont acheminées via systemd-resolved, ce qui échoue fréquemment.

    Si votre environnement n'utilise pas de domaines .local, vous pouvez supprimer le fichier gce-resolved.conf s'il est en conflit avec vos configurations existantes.

 Fonctionne avec les packages suivants pour configurer les instances.
  • google-guest-agent
  • google-compute-engine-oslogin
 guest-configs
google-compute-engine-oslogin Contient les fichiers binaires, les modules et les scripts nécessaires pour gérer l'accès aux instances à l'aide d'OS Login. OS Login vous permet de gérer l'accès aux instances à l'aide des rôles IAM. Pour en savoir plus sur OS Login, consultez OS Login.

Ce package contient les éléments suivants :

  • Commande "Authorized Keys" : commande qui utilise les clés SSH publiques pour authentifier les utilisateurs lors de la connexion.
  • Les modules NSS (Name Service Switch) : un service qui fournit au système les informations sur les utilisateurs et les groupes OS Login.
  • PAM (Pluggable Authentication Modules) : module qui permet la prise en charge de l'autorisation (et de l'authentification si la prise en charge à deux facteurs est activée). Ce module permet au système d'utiliser les autorisations IAM Cloud de Confiance by S3NSpour contrôler si le système peut se connecter à une instance ou effectuer des opérations en tant que racine (avec sudo).
  • google_oslogin_nss_cache : utilitaire permettant de mettre à jour le cache des utilisateurs et des groupes locaux.
  • selinux : package contenant les fichiers de définition de règles SELinux et un package de règles compilé pour configurer SELinux de manière à prendre en charge OS Login.
guest-oslogin
gce-disk-expand Contient les composants nécessaires pour redimensionner un disque de démarrage. Ils envoient des journaux au port série. gce-disk-expand
google-osconfig-agent Contient l'agent OS Config, que VM Manager utilise pour gérer l'inventaire, les correctifs et les règles de l'OS. Pour en savoir plus sur l'agent OS Config, consultez VM Manager.

Il lit et écrit des données dans les métadonnées de VM

Par défaut, l'agent OS Config ne collecte ni n'envoie aucune information tant que vous n'avez pas activé l'agent OS Config. Une fois l'agent activé, il communique avec le service de l'API OS Config. Pour connaître les opérations effectuées par l'agent, consultez la page Journalisation d'audit VM Manager.

 guest-osconfig

Composants Windows

Toutes les images d'OS Windows fournies par Google sont préconfigurées avec l'outil GooGet et les dépôts Cloud de Confiance . GooGet installe et gère l'environnement invité pour les instances Windows. Si vous devez installer GooGet et configurer des dépôts, consultez Packaging and package distribution (Empaquetage et distribution de packages) dans le dépôt GitHub compute-image-windows. Pour afficher la liste des packages installés sur votre instance Windows, connectez-vous à l'instance et exécutez googet installed.

L'environnement invité Windows inclut les packages clés suivants :

Nom du package Description Interactions clés Lien vers le code source sur GitHub
google-compute-engine-windows

Ce package est l'agent invité pour l'environnement Windows.

L'agent invité Windows contient les scripts qui s'exécutent sur le système d'exploitation invité pour assurer la compatibilité avec les fonctionnalités de Compute Engine. Pour en savoir plus sur l'agent invité, y compris sur ses fonctionnalités, son architecture et sa gestion, consultez Agent invité.
  • Il lit et écrit des données dans les métadonnées de VM
  • Il envoie des journaux au journal des événements de l'application Windows, au port série et à Cloud Logging.
 guest-agent
google-compute-engine-sysprep Contient des scripts permettant de généraliser une instance Windows en vue de la création d'une image d'OS. Le package inclut également le script instance_setup.ps1, qui s'exécute au premier démarrage pour configurer la nouvelle instance.
  • Il lit et écrit des données dans les métadonnées de VM
  • Il envoie des journaux au journal des événements de l'application de Windows et au port série.
 sysprep
google-compute-engine-metadata-scripts

Contient les scripts et les binaires qui exécutent les scripts sysprep-specialize, startup et shutdown.
  • Il lit et écrit des données dans les métadonnées de VM
  • Ils lisent les données à partir des emplacements Cloud Storage lorsque sysprep-specialize-script-url et windows-startup-script-url sont utilisés.
  • Il envoie des journaux au journal des événements de l'application Windows, au port série et à Cloud Logging.
google_metadata_script_runner
google-compute-engine-powershell Contient un module PowerShell. Ce module fournit des fonctions courantes utilisées par les scripts PowerShell dans les autres scripts d'environnement invité Windows. Il envoie des journaux au journal des événements de l'application de Windows et au port série. PowerShell
google-compute-engine-auto-updater

Contient les scripts qui mettent à jour quotidiennement les packages Compute Engine.

Ce package n'est pas installé par défaut. Cette approche vous permet de maintenir la stabilité de votre environnement en contrôlant le processus de mise à jour. Si votre environnement peut tolérer les mises à jour sans interruption, vous pouvez installer ce package pour vous assurer que vos packages d'environnement invité sont mis à jour automatiquement.

Pour installer ce package, utilisez la commande suivante : googet -noconfirm install google-compute-engine-auto-updater

  • Ils lisent les données des métadonnées de VM.
  • Appelle l'agent GooGet pour envoyer des journaux au journal des événements de l'application Windows et à la console
 auto_updater
google-compute-engine-diagnostics Contient un binaire qui collecte des informations de diagnostic depuis l'instance et les enregistre dans un bucket Cloud Storage. L'agent invité Windows exécute le binaire. Ils enregistrent les données dans un bucket Cloud Storage. diagnostics
certgen Contient un binaire qui crée un certificat sur l'instance. certgen
GooGet Contient un binaire qui installe et gère l'environnement invité pour les instances Windows. Lit les données des dépôts Cloud de Confiance situés à l'adresse packages.cloud.google.com GooGet
google-compute-engine-vss Installe l'agent et le fournisseur VSS Compute Engine qui capturent des instantanés de disque persistant à l'aide du service VSS (Volume Shadow Copy Service) de Microsoft. Ils communiquent avec le service d'instantané Cloud de Confiance by S3NS . vss
google-osconfig-agent Contient l'agent OS Config, que VM Manager utilise pour gérer l'inventaire, les correctifs et les règles de l'OS. Pour en savoir plus sur l'agent OS Config, consultez VM Manager.

Il lit et écrit des données dans les métadonnées de VM

Par défaut, l'agent OS Config ne collecte ni n'envoie aucune information tant que vous n'avez pas activé l'agent OS Config. Une fois l'agent activé, il communique avec le service de l'API OS Config. Pour examiner les opérations effectuées par l'agent, consultez la section Journalisation d'audit VM Manager.

 guest-osconfig
Pilotes Compute Engine pour Windows

Contient plusieurs pilotes pour assurer le bon fonctionnement et les performances des instances. Le gestionnaire de packages GooGet gère ces pilotes et les publie dans les dépôts Cloud de Confiance by S3NS .

Les pilotes Compute Engine suivants sont gérés pour les images d'OS Windows :

Type de pilote Nom du package du pilote
Adaptateur Ethernet google-compute-engine-driver-netkvm
Disque SCSI google-compute-engine-driver-vioscsi
Adaptateur d'écran google-compute-engine-driver-gga
Gestionnaire de plantage google-compute-engine-driver-pvpanic
Pilote de ballon de mémoire Virtio google-compute-engine-driver-balloon
Carte d'interface réseau virtuelle Google google-compute-engine-driver-gvnic

Pour installer ou mettre à niveau un pilote spécifique, exécutez la commande suivante : 

        googet install DRIVER_PACKAGE_NAME
compute-windows-drivers

Déploiements du dépôt de packages de l'environnement invité

À partir du 3 septembre 2026, Compute Engine passera d'un déploiement mondial à un déploiement régional des dépôts de packages d'environnement invité pour les instances de calcul Linux et Windows.

Principales modifications

  • Framework de déploiement régional : les mises à jour du dépôt stable par défaut sont disponibles région par région, plutôt que toutes en même temps à l'échelle mondiale.
  • Délai de déploiement progressif : il peut s'écouler jusqu'à deux semaines avant que les mises à jour des packages ne soient disponibles dans toutes les régions du monde.
  • Suivi du dépôt mondial : un suivi du dépôt mondial dédié est disponible pour les charges de travail nécessitant une cohérence des versions multirégionale. Les mises à jour de packages publiées dans le dépôt mondial continuent d'être déployées simultanément dans toutes les régions du monde une fois que tous les dépôts régionaux ont été mis à jour.

Impact potentiel

  • Variations de version : pendant la période de déploiement régional de deux semaines, les déploiements de charges de travail multirégionaux utilisant le dépôt stable par défaut peuvent présenter différentes versions de packages d'environnement invité dans les régions actives.
  • Ajustements de l'automatisation : si vous disposez d'automatisations, de pipelines CI/CD ou de processus de correction qui s'attendent à une cohérence des packages multirégionaux, vous devrez peut-être mettre à jour ces systèmes pour qu'ils utilisent le canal du dépôt mondial.

Choisir entre les déploiements régionaux et le canal du dépôt mondial

  • Si vos charges de travail peuvent tolérer des variations de version régionales lors des mises à jour : aucune action n'est requise.
  • Si vos workflows nécessitent une cohérence des packages multirégionaux : mettez à jour la configuration de votre gestionnaire de packages (APT, YUM/DNF, Zypper ou GooGet) avant le 3 septembre 2026 pour qu'elle pointe vers le nouveau dépôt mondial.

Modifications de la configuration du gestionnaire de paquets

Pour passer du canal régional par défaut au canal de dépôt global pour votre gestionnaire de packages, mettez à jour la configuration du dépôt de votre gestionnaire de packages afin qu'il pointe vers le canal global (-global).

  • APT (Debian)

    Dans /etc/apt/sources.list.d/google-cloud.list, remplacez le nom du dépôt de google-compute-engine-${VERSION_CODENAME}-stable par google-compute-engine-${VERSION_CODENAME}-global :

    deb [signed-by=/etc/apt/keyrings/google-keyring.gpg] http://packages.cloud.google.com/apt google-compute-engine-${VERSION_CODENAME}-global main

  • YUM et DNF (RHEL, CentOS, Rocky Linux)

    Dans le fichier de votre dépôt (par exemple, /etc/yum.repos.d/google-cloud.repo), mettez à jour l'entrée du dépôt pour utiliser le nom de piste global :

    [google-cloud-compute-global]
name=Google Cloud Compute Engine Global
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-compute-${DISTRO}-${ARCH}-global
enabled=1
gpgcheck=1

  • GooGet (Windows)

    Ajoutez ou mettez à jour le dépôt GooGet pour qu'il pointe vers google-compute-engine-global :

    googet addrepo google-compute-engine-global https://packages.cloud.google.com/yuck/repos/google-compute-engine-global

Étapes suivantes