Utilisez la vérification d'image lors de la création ou de l'importation d'une image pour valider une image. - Elastic Compute Service

Remarque

La création ou l'importation d'une image déclenche automatiquement une vérification. Cette opération n'interrompt pas le flux de travail, même en cas d'échec.
La vérification d'image est gratuite.
Les images validées reçoivent automatiquement des tags indiquant la version du système d'exploitation (acs:ecs:image:osVersion) et la version du noyau (acs:ecs:image:kernelVersion).

Limites

La vérification d'image prend uniquement en charge les images personnalisées créées à partir de snapshots non chiffrés ou d'instances ne disposant pas de disques cloud chiffrés.

Certains systèmes d'exploitation Linux et Windows ne sont pas pris en charge par la vérification d'image, comme indiqué dans les tableaux ci-dessous.

Systèmes d'exploitation Linux non pris en charge

Système d'exploitation	Version
Gentoo	Gentoo 13 64-bit
	Gentoo_32
	Gentoo_64
	Gentoo_arm64
Aliyun	LifseaOS 10 64-bit
	LifseaOS 3 64-bit
	LifseaOS 3 64-bit GPU Edition
FreeBSD	FreeBSD 10.1 64-bit
	FreeBSD 8.2 64-bit
	Freebsd_32
	Freebsd_64
	FreeBSD 11.1 64-bit
	FreeBSD 11.2 64-bit
	FreeBSD 11.3 64-bit
	FreeBSD 12.1 64-bit
	FreeBSD 11.4 64-bit
	Freebsd_arm64
	FreeBSD 13.0 64-bit
	FreeBSD 12.3 64-bit
CoreOS	CoreOS 681.2.0 64-bit
	CoreOS_32
	CoreOS_64
	CoreOS 1353.8.0 64-bit
	CoreOS 1465.8.0 64-bit
	CoreOS 1576.5.0 64-bit
	CoreOS 1688.5.3 64-bit
	CoreOS 1745.7.0 64-bit
	CoreOS 2023.4.0 64-bit
	CoreOS 2247.6.0 64-bit
	CoreOS 2303.3.0 64-bit
	CoreOS 2303.4.0 64-bit
	CoreOS 2345.3.0 64-bit
	CoreOS_arm64
Fedora CoreOS	FedoraCoreOS_64
	Fedora CoreOS 33.20210217.3.0_3
	FedoraCoreOS_arm64
	Fedora CoreOS 34.20210529.3.0_3
Solaris	Solaris 10u8 64-bit
mars	Aliyun Customized Linux
Customized Linux	CustomizedLinux_64
	CustomizedLinux_32
	CustomizedLinux_arm64

Systèmes d'exploitation Windows non pris en charge

Système d'exploitation	Version
Windows Server 2008	Windows Server 2008 Standard Edition 64-bit Chinese Edition
	Windows Server 2008 Standard Edition 64-bit English Edition
	Windows Server 2008 Standard Edition SP2 32-bit Chinese Edition
	Windows Server 2008 Enterprise Edition 32-bit Chinese Edition
	Windows Server 2008 Standard Edition SP2 32-bit English Edition
	WindowsServer2008_64
	WindowsServer2008_32
	Windows Server 2008 Standard Edition SP2 32-bit Japanese Edition
Windows Server 2003	Windows Server 2003 R2 Standard Edition SP2 64-bit Chinese Edition
	Windows Server 2003 R2 Standard Edition SP2 32-bit Chinese Edition
	Windows Server 2003 R2 Standard Edition SP2 64-bit English Edition
	Windows Server 2003 R2 Enterprise Edition 64-bit English Edition
	Windows Server 2003 R2 Enterprise Edition 64-bit Chinese Edition
	Windows Server 2003 R2 Enterprise Edition 32-bit Chinese Edition
	WindowsServer2003_64
	WindowsServer2003_32
Windows 7	Windows7_32
Windows 8	Windows8_32
Windows 10	Windows10_32

Configurer la vérification d'image

Lors de la création d'une image

Console

Lorsque vous créez une image personnalisée dans la console ECS, une vérification d'image s'exécute par défaut. Aucune modification n'est nécessaire. Pour plus d'informations, consultez les rubriques Créer une image personnalisée à partir d'une instance et Créer une image personnalisée à partir d'un snapshot.

API

Définissez le paramètre DetectionStrategy=Standard en appelant l'opération CreateImage. Exécutez cette opération sur OpenAPI Explorer pour éviter de calculer les signatures et générer automatiquement des exemples de code SDK.

Lors de l'importation d'une image

Console

Lorsque vous importez une image personnalisée dans la console ECS, une vérification d'image s'exécute par défaut. Aucune modification n'est nécessaire. Pour plus d'informations, consultez la rubrique Importer une image personnalisée.

API

Définissez le paramètre DetectionStrategy=Standard dans l'opération ImportImage. Exécutez cette opération sur OpenAPI Explorer pour éviter de calculer les signatures et générer automatiquement des exemples de code SDK.

Résultats de la vérification d'image

Console

Sur la page Images personnalisées, repérez l'image que vous avez créée. Une tâche de vérification d'image s'exécute automatiquement une fois que le statut de l'image passe à Available.
Survolez le résultat de la vérification et cliquez sur View Details pour afficher les détails. Une fois la vérification terminée, la colonne Check Result indique le statut. Survolez le résultat pour voir le nombre d'éléments Critical, Suggested et Passed, puis cliquez sur View Details pour consulter le rapport complet.
Si des éléments nécessitent des corrections, appliquez les recommandations suivantes.
- (Pour les images Linux uniquement) Cliquez sur {value,select, repair {Repair Now} other {Create} } et utilisez le modèle public ACS-ECS-RepairImage dans CloudOps Orchestration Service (OOS) pour résoudre les problèmes.
- Vous pouvez également corriger manuellement les problèmes en suivant les recommandations affichées dans les détails de l'image. Pour obtenir la liste des éléments vérifiés et les suggestions de réparation, consultez la section Éléments de vérification d'image et suggestions de réparation.
La page des résultats de vérification classe les éléments en trois catégories : aucun risque détecté, corrections critiques et optimisations recommandées. Chaque catégorie répertorie les éléments vérifiés spécifiques et fournit des liens pour appliquer les correctifs ou optimisations.

API

Appelez l'opération DescribeImages et utilisez l'ID de l'image pour interroger les résultats. Exécutez cette opération sur OpenAPI Explorer. Cet outil simplifie le processus en gérant le calcul des signatures et en générant automatiquement des exemples de code SDK.

Remarque

Dans la réponse, DetectionOptions contient les résultats de la détection, Status indique le statut de la tâche et Item contient le résultat pour chaque élément vérifié.

Vérifications et corrections d'images

Linux

Élément vérifié	Description	Correction recommandée
GUESTOS.Platform	Plateforme du système. Doit être un système d'exploitation Linux.	Sans objet
GUESTOS.OSVersion	Version du système d'exploitation.	Sans objet
GUESTOS.Architecture	Architecture du système.	Sans objet
GUESTOS.RtcTimeMode	Spécifie le fuseau horaire de l'horloge matérielle (RTC) de l'image. Les valeurs valides sont UTC ou local. Il est recommandé de définir l'horloge matérielle sur UTC.	Pour définir l'horloge matérielle sur UTC, consultez la rubrique Heure et fuseaux horaires sous Linux.
GUESTOS.BootMode	Mode de démarrage de l'image. Les valeurs valides sont LEGACY ou UEFI.	Sans objet
GUESTOS.KernelVersion	Version du noyau.	Sans objet
GUESTOS.Virtio	Vérifie si le pilote virtio est installé. Les instances ECS nécessitent ce pilote pour la virtualisation et peuvent échouer au démarrage sans celui-ci.	Pour installer le pilote virtio pour une image, consultez la rubrique Installer le pilote virtio.
GUESTOS.Nvme	Vérifie si le pilote NVMe est installé. Certaines familles d'instances ECS, telles que ecs.g7se, utilisent des disques cloud attachés via NVMe et requièrent ce pilote dans l'image.	Pour installer le pilote NVMe pour une image, consultez la rubrique Comment installer le pilote NVMe pour une image personnalisée existante ?.
GUESTOS.Fstab	Vérifie le fichier `/etc/fstab`. Des configurations incorrectes, telles que des périphériques inexistants ou des UUID de périphérique erronés, peuvent entraîner des échecs de démarrage du système.	Pour configurer correctement `/etc/fstab`, consultez la rubrique Configurer les UUID dans le fichier fstab pour monter automatiquement les disques de données.
GUESTOS.Grub	Vérifie la configuration du chargeur de démarrage GRUB. Des paramètres incorrects, tels que des chemins de périphérique ou des UUID invalides, peuvent provoquer des échecs de démarrage du système.	Aucune
GUESTOS.Dhcp	Vérifie si le réseau est configuré pour DHCP. L'utilisation d'une adresse IP statique dans l'image peut entraîner des pannes réseau au démarrage de l'instance.	Pour définir le mode de configuration réseau de l'image sur DHCP, consultez la rubrique Configurer DHCP pour une instance Linux.
GUESTOS.Selinux	Vérifie si SELinux est désactivé. Il est recommandé de désactiver SELinux dans les images cloud pour éviter d'éventuels échecs de démarrage.	Pour désactiver SELinux, consultez la rubrique Activer ou désactiver SELinux.
GUESTOS.OnlineResizeFS	Vérifie si l'image prend en charge le redimensionnement automatique de la partition racine. Si l'image dispose de cloud-init, de la commande `growpart` et d'autres outils requis installés, la partition racine d'une instance créée à partir de cette image s'étend automatiquement. Par exemple, si vous créez une instance avec un disque système de 100 Go à partir d'une image de 20 Go, la partition racine s'étend à 100 Go.	Pour configurer l'image afin qu'elle prenne en charge le redimensionnement automatique, consultez la rubrique Installer cloud-init.
GUESTOS.SystemImage	Vérifie si l'image est une image de disque système valide. N'importez pas d'images invalides, telles que des images ISO ou des images vides.	Sans objet
GUESTOS.CloudAssistant	Vérifie si Cloud Assistant est installé. Cloud Assistant est un outil natif d'automatisation et de gestion pour ECS qui vous permet d'exécuter des opérations par lots, d'exécuter des commandes (telles que Shell, PowerShell et Bat) et de transférer des fichiers sur les instances ECS sans mot de passe, connexion ni hôte de rebond. L'installation de Cloud Assistant est recommandée pour une gestion efficace des instances.	Pour installer Cloud Assistant, consultez la rubrique Installer l'agent Cloud Assistant.
GUESTOS.CloudInit	Vérifie si cloud-init est installé dans l'image. cloud-init est la norme industrielle pour l'initialisation des instances cloud, gérant des tâches de configuration telles que les noms d'hôte, les paires de clés SSH et le redimensionnement de la partition racine.	Pour installer cloud-init pour une image, consultez la rubrique Installer cloud-init.
GUESTOS.SecurityCenterAgent	Vérifie si l'agent Security Center est installé dans l'image. Security Center est un système de gestion de sécurité unifié qui offre une détection des menaces et une protection en temps réel. Ses fonctionnalités incluent une vue d'ensemble de la posture de sécurité, la protection contre les ransomwares, les antivirus, la prévention de la falsification et les contrôles de conformité pour détecter et protéger de manière exhaustive vos serveurs et applications web.	Pour installer l'agent Security Center pour une image, consultez la rubrique Installer le client.
GUESTOS.SupportMocInstanceTypes	Vérifie si l'image prend en charge les familles d'instances ECS Bare Metal. Les dernières familles d'instances ECS, telles que ecs.g6 et ecs.g7, sont souvent basées sur l'architecture ECS Bare Metal Instance. Une instance peut échouer au démarrage sur ces familles si la version du système d'exploitation et du noyau de l'image est obsolète. Pour plus d'informations sur les familles d'instances, consultez la rubrique Famille d'instances.	Si vous utilisez CentOS 5, il est recommandé de mettre à niveau vers la dernière version, CentOS 5.11. Pour plus d'informations, consultez la rubrique Comment résoudre l'arrêt intempestif d'une instance après migration ?. Les systèmes d'exploitation qui ne prennent pas en charge les familles d'instances ECS Bare Metal sont souvent des versions anciennes ayant atteint leur fin de vie (EOL). Il est recommandé de mettre à niveau dès que possible vers une version de système d'exploitation activement maintenue par son éditeur.

Windows

Élément vérifié	Description	Correction recommandée
GUESTOS.Platform	Plateforme du système. Doit être un système d'exploitation Windows.	Sans objet
GUESTOS.OSVersion	Version du système d'exploitation.	Sans objet
GUESTOS.Architecture	Architecture du système.	Sans objet
GUESTOS.KernelVersion	Version du noyau.	Sans objet
GUESTOS.Virtio	Vérifie si le pilote virtio est installé. Les instances ECS nécessitent ce pilote pour fonctionner correctement et peuvent échouer au démarrage sans celui-ci.	Pour installer le pilote virtio pour une image, consultez la rubrique Installer le pilote virtio.
GUESTOS.BCD	Vérifie si le fichier Boot Configuration Data (BCD) de l'image est valide. Un fichier BCD manquant ou corrompu peut entraîner des échecs de démarrage de l'instance.	Utilisez le fichier BCD correct.
GUESTOS.Registry	Vérifie si les fichiers du registre de l'image sont valides. Des fichiers de registre manquants ou corrompus peuvent entraîner des échecs de démarrage de l'instance.	Utilisez les fichiers de registre corrects.
GUESTOS.Hotfix	Vérifie l'installation correcte des correctifs. L'absence de correctifs requis ou l'installation de correctifs connus pour être problématiques peut entraîner des échecs de démarrage de l'instance.	Désinstallez les correctifs incorrects. Les correctifs incorrects incluent KB5009624, KB5009595, KB5009546, KB5009557, KB5009555, KB5014738, KB5014702, KB5014692 et KB5014678. Pour les systèmes d'exploitation Microsoft Windows Server 2008 R2 64 bits, vous devez également installer le correctif KB3033929.
GUESTOS.Disk	Vérifie si les paramètres de disque sont corrects. Des entrées de pilotes résiduelles dans le registre peuvent entraîner des échecs de démarrage de l'instance.	Supprimer les pilotes résiduels du registre
GUESTOS.Sysprep	Vérifie si Sysprep s'est terminé avec succès lors de la création de l'image. Un processus Sysprep interrompu, par exemple par un arrêt forcé, peut empêcher le démarrage de l'instance résultante.	Recréez l'image. Assurez-vous que le processus Sysprep n'est pas interrompu. Pour plus d'informations, consultez la rubrique Créer une machine virtuelle et installer un système d'exploitation.
GUESTOS.Update	Vérifie si le processus de mise à jour s'est terminé lors de la création de l'image. Si le processus de mise à jour a été interrompu, par exemple par un arrêt forcé, l'instance peut échouer au démarrage.	Recréez l'image. Assurez-vous que le processus de mise à jour du système n'est pas interrompu. Pour plus d'informations, consultez la rubrique Créer une machine virtuelle et installer un système d'exploitation.
GUESTOS.Xen	Vérifie la présence de pilotes Xen résiduels, qui peuvent entraîner des échecs de démarrage du système.	Désactiver le pilote Xen
GUESTOS.CloudAssistant	Vérifie si Cloud Assistant est installé. Cloud Assistant est un outil natif d'automatisation et de gestion pour ECS qui vous permet d'exécuter des opérations par lots, d'exécuter des commandes (telles que Shell, PowerShell et Bat) et de transférer des fichiers sur les instances ECS sans mot de passe, connexion ni hôte de rebond. L'installation de Cloud Assistant est recommandée pour une gestion efficace des instances.	Pour installer Cloud Assistant, consultez la rubrique Installer l'agent Cloud Assistant.
GUESTOS.Server	Vérifie si les configurations de service dans l'image sont correctes. Si l'installation des pilotes est désactivée, l'instance ne pourra pas mettre à jour ses pilotes.	Autoriser l'installation des pilotes
GUESTOS.DesktopConfig	Vérifie si le fichier de configuration du bureau (desktop.ini) est manquant. S'il est absent, les paramètres du bureau ne seront pas appliqués.	Configurez le fichier desktop.ini correct.
GUESTOS.BootMgr	Vérifie si le gestionnaire de démarrage du système (BootMgr) est manquant. L'absence de BootMgr empêche le système de démarrer.	Configurez le BootMgr correct.

Supprimer les pilotes résiduels

L'arborescence de registre HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control contient les informations de configuration qui contrôlent le démarrage du système et certains périphériques. Sa sous-clé Class contient les pilotes de filtre enregistrés sur le périphérique. Des entrées de pilotes résiduelles provenant de logiciels désinstallés peuvent empêcher le démarrage des instances créées à partir de l'image. Cette section explique comment nettoyer manuellement ces entrées résiduelles.

Connectez-vous au serveur source à partir duquel le fichier image a été créé.
Ouvrez l'Éditeur du Registre.

Par exemple, sous Windows 10, saisissez regedit dans la zone de recherche de la barre des tâches et appuyez sur Entrée.
Ouvrez la clé de registre du disque.

Le chemin d'accès est HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Class\{4d36e967-e325-11ce-bfc1-08002be10318}.
Confirmez et supprimez les entrées de pilotes résiduelles.
1. Vérifiez la valeur de la propriété UpperFilter pour identifier les entrées de pilotes résiduelles.
  
  Une entrée est considérée comme résiduelle si son fichier de pilote correspondant est absent de C:\Windows\System32\drivers mais que son entrée reste présente dans UpperFilters.
  
  Avertissement
  Soyez prudent lorsque vous supprimez des entrées de pilotes. Assurez-vous que le pilote n'est pas un pilote par défaut du système afin d'éviter des anomalies système.
  
  Par exemple, partmgr est un pilote par défaut du système et ne doit pas être supprimé de UpperFilters. Dans le chemin de registre HKEY_LOCAL_MACHINE\OfflineSYSTEM\ControlSet001\Control\Class\{4d36e967-e325-11ce-bfc1-08002be10318}, la valeur de UpperFilters est partmgr. Il s'agit d'un pilote par défaut du système et il n'est pas nécessaire de le supprimer.
2. Dans UpperFilters, supprimez les noms des pilotes résiduels.

Désactiver le pilote Xen

Les instances ECS n'utilisent pas le pilote Xen. Toutefois, les anciennes images peuvent contenir des entrées de pilotes Xen résiduelles susceptibles de provoquer des échecs de démarrage. Vous pouvez désactiver le pilote Xen dans le registre.

Connectez-vous au serveur source à partir duquel le fichier image a été créé.
Ouvrez l'Éditeur du Registre.

Par exemple, sous Windows 10, saisissez regedit dans la zone de recherche de la barre des tâches et appuyez sur Entrée.
Ouvrez la clé de registre correspondante.

Le chemin d'accès est HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\XenPCI\Parameters.
Effacez la valeur de la propriété hide_devices.

Double-cliquez sur la propriété hide_devices. Dans la boîte de dialogue qui s'affiche, effacez les données de valeur, puis cliquez sur OK.

Autoriser l'installation des pilotes

L'arborescence de registre HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services enregistre tous les services du système. Certains services contrôlent si les pilotes peuvent être installés. Si l'installation des pilotes est désactivée dans le registre de l'image, les instances créées à partir de celle-ci ne pourront pas mettre à jour leurs pilotes. Vous devez modifier la propriété qui désactive ce paramètre.

Connectez-vous au serveur source à partir duquel le fichier image a été créé.
Ouvrez l'Éditeur du Registre.

Par exemple, sous Windows 10, saisissez regedit dans la zone de recherche de la barre des tâches et appuyez sur Entrée.
Ouvrez la clé de registre correspondante.
- Pour Windows Server 2008 R2 et versions ultérieures : HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DeviceInstall\Parameters.
- Pour Windows Server 2008 R2 et versions antérieures : HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\PlugPlay\Parameters.
Modifiez la propriété qui désactive l'installation des pilotes. Si la propriété DeviceInstallDisabled existe et que sa valeur n'est pas 0, changez sa valeur en 0 ou supprimez la propriété.
- Par exemple, sous Windows Server 2008 R2, cette propriété est de type REG_DWORD et se trouve dans le chemin de registre HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\PlugPlay\Parameters.
- Par exemple, sous Windows Server 2016, si la propriété DeviceInstallDisabled de type REG_DWORD dans le chemin de registre HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DeviceInstall\Parameters a une valeur de 1, vous devez changer la valeur en 0 ou supprimer la propriété.

Étapes suivantes

Après avoir vérifié et réparé une image personnalisée, vous pouvez l'utiliser pour créer une instance ECS. Pour plus d'informations, consultez la rubrique Créer une instance à partir d'une image personnalisée ou partagée.