Comment résoudre le blocage d'une instance Image Builder AppStream 2.0 à l'état En attente ?

Date de la dernière mise à jour : 08/06/2022

Lorsque j'essaie de lancer une instance Image Builder Amazon AppStream 2.0, celle-ci reste bloquée à l'état En attente et ne passe pas à l'état En cours d'exécution. Comment puis-je résoudre ce problème ?

Résolution

Remarque : si vous recevez des erreurs lors de l'exécution de commandes de l’interface de la ligne de commande AWS (AWS CLI), assurez-vous d'utiliser la version la plus récente d'AWS CLI.

Il vous faudra patienter jusqu'à 25 minutes avant que les instances Image Builder et de flotte deviennent disponibles et passent à l’état En cours d'exécution. Si votre instance Image Builder affiche toujours l'état En attente après 25 minutes, consultez les causes courantes suivantes et leurs procédures de dépannage respectives.

L'interface réseau Elastic est supprimée ou détachée

Une interface réseau manquante peut empêcher l'instance Image Builder de terminer les flux de travail de démarrage, laissant l'instance bloquée à l'état En attente.

Pour vérifier l'état de votre interface réseau, ouvrez la console Amazon Elastic Compute Cloud (Amazon EC2), puis sélectionnez Interfaces réseau. Ou, pour utiliser l'interface de ligne de commande AWS, exécutez la commande suivante :

aws ec2 describe-network-interfaces --filters 'Name=description,Values="AppStream 2.0 - image-builder:*"'

Si l'interface réseau est manquante ou détachée, lancez une nouvelle instance Image Builder à partir de la dernière image de travail. Vous pouvez également utiliser une image de base fournie par AWS.

Remarque : vous pouvez consulter vos journaux AWS CloudTrail pour connaître les détails des événements associés à la suppression ou au détachement de l'interface réseau, y compris eventTime et userIdentity.

Applications utilisant des paquets AppX

Les applications utilisant des paquets AppX tels qu'Adobe Creative Cloud peuvent provoquer l'échec de sysprep et le blocage des instances Image Builder à l'état En attente.

Exécutez les commandes suivantes dans PowerShell en tant qu'administrateur avant de terminer la dernière étape du processus de création d'image.

Pour obtenir la liste des paquets AppX sur la machine, saisissez la commande suivante :

Get-AppxPackage | select Name, PackageFullName

Pour supprimer un package AppX spécifique, saisissez la commande suivante. Remplacez AppXPackageName par le package que vous supprimez, comme indiqué dans la sortie de la commande précédente :

Get-AppxPackage -AllUsers -Name AppXpackageName | Remove-AppxPackage -AllUsers

Remarque : l’instance Image Builder doit exécuter Server 2019. Le paramètre -AllUsers a été ajouté dans la version 1709. Server 2016 dans l’instance Image Builder s'exécute sur la version 1607 et renvoie une erreur avec le paramètre -AllUsers.

Pour plus d'informations, consultez Get-AppxPackage sur le site Web de Microsoft.

Les pilotes d'appareil sont en conflit ou incorrects

L'instance Image Builder est préinstallée avec tous les pilotes requis. L'instance Image Builder peut rester à l'état En attente si un utilisateur installe des pilotes en conflit ou incorrects.

Le générateur d'images étant inaccessible, il n'est pas possible de désinstaller les pilotes incorrects ou en conflit. Pour résoudre ce problème, lancez une nouvelle instance Image Builder à partir d'une image personnalisée récente ou à l'aide de l'une des images de base fournies par Amazon.

Limites de l'interface réseau

Votre compte AWS a peut-être atteint les limites de l'interface réseau pour la région. Pour en savoir plus sur les limites et sur la procédure à suivre pour demander leur augmentation, consultez la section Quotas Amazon VPC.

Problèmes de personnalisation des fichiers de réponses Sysprep

Il est recommandé de ne pas personnaliser le fichier de réponses sysprep Unattend. Une personnalisation incorrecte peut interférer avec le processus de démarrage Windows en empêchant l’instance Image Builder de démarrer correctement et de rester bloquée sur l'écran d'accueil.

Pour résoudre ce problème, lancez une nouvelle instance Image Builder à partir d'une image personnalisée récente ou à l'aide de l'une des images de base fournies par Amazon.

IPv6 est désactivé

Si vous créez une image tandis que IPv6 est désactivé, l'instance Image Builder restera à l'état En attente. Pour résoudre ce problème, lancez une nouvelle instance Image Builder à partir d'une image personnalisée récente ou à l'aide de l'une des images de base fournies par Amazon.

Disponibilité des ports

Vérifiez qu'aucune application installée n'utilise les ports suivants :

  • TCP entrant sur le port 8300, pour créer la connexion de streaming.
  • TCP entrant sur les ports 8000 et 8443, pour la gestion de l'instance de streaming par AppStream 2.0.

Pour en savoir plus, consultez la section Plage d'adresses IP et ports de l'interface réseau de gestion.

Pour autoriser l'accès au service de métadonnées Amazon EC2, toutes les instances de streaming nécessitent que le port 80 (HTTP) soit ouvert à l'adresse IP 169.254.169.254. Si un proxy est configuré, le proxy doit exclure 169.254.169.254. Pour plus d'informations, consultez la section Ports d'interface réseau client.

Exceptions du logiciel antivirus

Un logiciel antivirus peut bloquer les fichiers et les ports dont l'instance Image Builder a besoin. Pensez à ajouter des exceptions aux chemins de dossier suivants :

  • %PROGRAMFILES%\Amazon\*
  • %PROGRAMFILES%\NICE\*
  • %PROGRAMFILES%\nodejs\*
  • %PROGRAMFILES%\Internet Explorer\*
  • C:\Windows\*

Ces chemins de dossier correspondent aux services suivants :

  • AWSLiteAgent
  • AmazonSSMAgent
  • Ec2Config
  • PhotonAgent
  • PhotonAgentWebServer (écoute sur le port 8443)
  • DcvServer (écoute sur le port 8300)
  • QWAVE

Informations d'identification AWS CLI en tant que variables d'environnement système

La définition des informations d'identification AWS CLI en tant que variables d'environnement système peut empêcher AppStream 2.0 de créer l'image. Pour connaître la marche à suivre pour modifier les variables d'environnement système entre vos instances de parc, consultez la section Modifier les variables d'environnement système.

Langue par défaut remplacée par une langue non prise en charge

Vous pouvez configurer les paramètres régionaux par défaut pour vos sessions de streaming AppStream 2.0, y compris la langue d'affichage. Une instance Image Builder sera bloquée à l'état En attente si vous remplacez la langue par défaut par une langue non prise en charge. Pour afficher les langues actuellement prises en charge par AppStream 2.0, consultez la section Spécifier une langue d'affichage par défaut.

Compte administrateur local supprimé ou renommé

AppStream 2.0 ne prend pas en charge le renommage ou la suppression du compte d'administrateur local. Si vous renommez ou supprimez ce compte, la création de l'image échoue.

Pour les instances Image Builder associées à un domaine, si le compte d'administrateur local est désactivé, supprimé ou renommé par la stratégie de groupe, vous pouvez mettre à jour l'objet Stratégie de groupe (GPO).

Si le compte d'administrateur local n'est pas mis à jour par le GPO, lancez une nouvelle instance Image Builder à partir d'une image personnalisée récente. Vous pouvez également utiliser l'une des images de base fournies par Amazon.

Codes de notification (instances Image Builder associées à un domaine)

Pour afficher les notifications, ouvrez la console AppStream 2.0, puis sélectionnez Images dans le volet de navigation. Dans l'onglet Image Builder, sélectionnez votre instance Image Builder, puis l'onglet Notifications. Pour en savoir plus, consultez la section Résolution des problèmes de codes de notification.

  • DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN L'instance Image Builder ne peut pas contacter le domaine Active Directory. Cela empêche l'instance Image Builder de terminer les flux de travail de démarrage. Pour vous assurer de la connectivité réseau, confirmez vos paramètres de VPC, sous-réseau et groupe de sécurité. Vérifiez que les serveurs DNS VPC sont correctement configurés dans la section Jeu d'options DHCP de votre VPC. Les serveurs de noms de domaine sont généralement définis sur les adresses IP des contrôleurs de domaine ou des serveurs DNS responsables de votre domaine. Pour obtenir des informations supplémentaires, consultez la section Jeux d'options DHCP.
  • DOMAIN_JOIN_ERROR_FILE_NOT_FOUND Le nom unique de l'unité d'organisation (UO) n'est pas valide. Les objets ordinateur AppStream 2.0 doivent être placés dans une unité d'organisation et le nom unique doit commencer par OU=. Pour en savoir plus, consultez la section Recherche du nom unique de l'unité d'organisation.

Configuration du pare-feu et du réseau (instances Image Builder associées à un domaine)

Avant d'ajouter un objet Directory Config à votre instance Image Builder à l'aide de la console AppStream 2.0, vérifiez que le pare-feu et la configuration réseau sont corrects. Procédez comme suit.

1.    Ouvrez une fenêtre PowerShell depuis votre instance Image Builder, puis exécutez les commandes suivantes :

Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 389 -InformationLevel "Detailed"
Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 88 -InformationLevel "Detailed"
Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 53 -InformationLevel "Detailed"

2.    Pour la sortie de chaque commande, vérifiez que TcpTestSucceeded présente la valeur True. Cette valeur indique que vous pouvez atteindre les ports requis pour joindre le domaine. Pour plus d'informations, consultez Test-NetConnection sur le site Web de Microsoft.

3.    Dans la même fenêtre PowerShell, exécutez la commande Resolve-DnsName pour confirmer que vous pouvez rechercher le nom de domaine :

Resolve-DnsName -Name yourdomain.exampleco.com

Vous pouvez également télécharger et exécuter l'outil Microsoft PortQryUI pour valider tous les ports requis.

Nouvel objet ordinateur non créé (instances Image Builder associées à un domaine)

Dans Active Directory, vérifiez si un nouvel objet ordinateur a été créé dans les unités d'organisation appropriées.

S'il existe un nouvel objet, alors l'instance Image Builder sera bientôt disponible.

Si l'objet ordinateur n'est pas créé, alors l'instance Image Builder reste à l'état En attente. Pour résoudre ce problème, assurez-vous tout d'abord que toutes les autorisations de compte de service requises sont accordées. Ensuite, vérifiez que les détails de configuration de répertoire suivants dans votre objet Directory Config AppStream 2.0 sont corrects :

  • Nom du répertoire (nom de domaine complet du répertoire)
  • Nom utilisateur et mot de passe du compte de service
  • Nom unique de l'unité d'organisation