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 mises à jour dans tous les pays 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é

Le composant central de l'environnement invité est l'agent invité, qui 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 les 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 l'OS invité pour prendre en charge les fonctionnalités 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 nécessaires à 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, les règles sysctl, les configurations rsyslog et les configurations dhcp, utilisées pour définir le nom d'hôte
  • Scripts Bash qui s'exécutent lors du 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 routé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 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 "Clés autorisées" : commande qui utilise les clés SSH publiques pour authentifier les utilisateurs lors de la connexion.
  • Modules NSS (Name Service Switch) : service qui fournit au système les informations sur les utilisateurs et les groupes OS Login.
  • Modules d'authentification connectables (PAM) : module qui fournit une assistance pour l'autorisation (et l'authentification si la prise en charge de l'authentification à deux facteurs est activée). Ce module permet au système d'utiliser les autorisations IAM Google Cloudpour contrôler si le système peut se connecter à une instance ou effectuer des opérations en tant que root (avec sudo).
  • google_oslogin_nss_cache : utilitaire permettant de mettre à jour le cache local des utilisateurs et des groupes.
  • selinux : package contenant des fichiers de définition de règles SELinux et un package de règles compilé pour configurer SELinux afin de prendre en charge OS Login.
guest-oslogin
gce-disk-expand Contient les composants requis 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 examiner les opérations effectuées par l'agent, consultez la section Journaux 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 Google Cloud . 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 (Packaging 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 l'OS invité pour prendre en charge les fonctionnalités 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 de 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 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
  • Lit les données 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 de 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 Windows et au port série. PowerShell
google-compute-engine-auto-updater

Contient des 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 les 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 à partir de 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 Google Cloud situés à l'adresse packages.cloud.google.com GooGet
google-compute-engine-vss Installe l'agent et le fournisseur VSS Compute Engine qui prennent des instantanés de disque persistant à l'aide du Volume Shadow Copy Service (VSS) de Microsoft. Communique avec le service d'instantanés Google Cloud 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 de 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 Google Cloud .

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 plantages 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 de l'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 globalement en même temps.
  • Délai de déploiement progressif : la mise à jour des packages peut prendre jusqu'à deux semaines pour être déployée dans tous les pays.
  • Piste de dépôt globale : une piste de dépôt globale dédiée 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 charge de travail multirégionaux utilisant le dépôt stable par défaut peuvent afficher différentes versions de packages d'environnement invité dans les régions actives.
  • Ajustements d'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 suivi du dépôt mondial.

Choisir d'utiliser les déploiements régionaux ou 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 de la piste régionale par défaut à la piste de dépôt globale pour votre gestionnaire de packages, mettez à jour la configuration du dépôt de votre gestionnaire de packages afin qu'elle pointe vers la piste globale (-global).

  • APT (Debian)

    Dans /etc/apt/sources.list.d/google-cloud.list, remplacez le nom du dépôt 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 la piste globale :

    [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