Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Dépannage et diagnostic

Cette section fournit des conseils pour résoudre les problèmes courants susceptibles de survenir lors de la migration des applications IIS vers Elastic Beanstalk.

Associer une EC2 paire de clés à votre environnement

Vous pouvez vous connecter en toute sécurité aux instances Amazon Elastic Compute Cloud (Amazon EC2) fournies pour votre application Elastic Beanstalk à l'aide d'une paire de clés Amazon. EC2 Pour obtenir des instructions sur la création d'une paire de clés, consultez la section Création d'une paire de clés à l'aide d'Amazon EC2 dans le guide de EC2 l'utilisateur Amazon.

La spécification d'un nom de clé eb migrate a pour effet d'associer votre environnement Elastic Beanstalk à la paire de clés. Pour des raisons de sécurité, cela n'ouvrira pas le port 3389 sur le groupe de sécurité de votre EC2 instance. Vous pouvez associer des groupes EC2 de sécurité supplémentaires autorisant le trafic du port 3389 à passer eb config après la migration initiale.

PS C:\migrations_workspace> eb migrate  `
    --keyname "my-keypair"  `
    --verbose

Lorsque vous créez une paire de clés, Amazon EC2 stocke une copie de votre clé publique. Si vous n'avez plus besoin de l'utiliser pour vous connecter à des instances d'environnement, vous pouvez le supprimer d'Amazon EC2. Pour en savoir plus, consultez Supprimer votre paire de clés dans le guide de EC2 l'utilisateur Amazon.

Pour plus d'informations sur la connexion aux EC2 instances Windows Amazon, consultez Connexion à une instance Windows.

Accès aux journaux

L'EB CLI fournit une eb logs fonctionnalité que vous pouvez utiliser pour récupérer les journaux d'un environnement Elastic Beanstalk sans vous connecter à ses instances. EC2 Après l'exécution deeb migrate, vous pouvez lancer la eb logs --zip commande qui téléchargera et enregistrera les journaux dans le .elasticbeanstalk\logs répertoire.

Vous pouvez également consulter les journaux via la console AWS Elastic Beanstalk. Pour de plus amples informations, veuillez consulter Afficher les journaux des EC2 instances Amazon dans votre environnement Elastic Beanstalk.

Accès aux artefacts côté client

La eb migrate commande stocke les journaux d'applications et d'erreurs générés par les répertoires d'artefacts des migrations msdeploy internes.

./migrations/
├── latest -> migration_20240308_123456/
└── migration_20240308_123456/
    ├── application.log
    ├── error.log
    └── upload_target\

Surveillance de la santé de l'environnement

Elastic Beanstalk vous aide à surveiller l'état de santé à l'aide des fonctionnalités améliorées de surveillance de l'état de santé. Il s'agit d'un système de surveillance automatique de l'état de santé qui suit en permanence l'état opérationnel des instances d'application, en tirant parti de mesures intégrées telles que l'utilisation du processeur, la latence, le nombre de demandes et les codes de réponse.

Le système de surveillance de l'état utilise une approche basée sur des agents pour collecter des données au niveau de l'instance et intègre la journalisation et les alertes en temps réel. Elastic Load Balancing (ELB) et Auto Scaling répondent de manière dynamique aux changements d'état de santé, garantissant ainsi une disponibilité et une tolérance aux pannes élevées. Les modes de surveillance avancés, notamment les rapports de santé améliorés, fournissent une visibilité précise du comportement des applications, permettant un dépannage proactif et des mécanismes de restauration automatique.

Exécutez la eb health commande EB CLI pour afficher l'état de santé de l'environnement. Les informations suivantes s'affichent :

EC2 optimisation des performances

Par défaut, eb migrate sélectionne le type d'instance c5.2xlarge pour offrir une première expérience optimale avec Elastic Beanstalk. Vous pouvez modifier ce comportement avec l'--instance-typeargument suivant :

PS C:\migrations_workspace> eb migrate `
    --instance-type "t3.large"

Pour les environnements de production, tenez compte des facteurs suivants lors de la sélection d'un type d'instance :

Configuration du volume EBS

Par défaut, Elastic Beanstalk crée uniquement un volume root C:\ block-device () pour votre environnement. Vous pouvez transmettre des volumes de snapshots Amazon Elastic Block Store supplémentaires avec l'--ebs-snapshotsoption suivante :

PS C:\migrations_workspace> eb migrate `
    --ebs-snapshots "snap-123456789abc"

Pour des exemples illustrant la manière dont vous pouvez configurer des mappages par blocs avec Elastic Beanstalk, consultez l'article de blog Customize Ephemeral et EBS volumes in Elastic Beanstalk Environments.

Pour les applications nécessitant beaucoup de stockage, envisagez les options suivantes :

Problèmes courants et solutions correspondantes

Événement : installation manquante de Web Deploy

Si vous rencontrez des erreurs liées à l'impossibilité de trouver Web Deploy, installez Web Deploy 3.6 ou version ultérieure à partir du programme d'installation de Microsoft Web Platform. L'exemple suivant affiche un message d'erreur possible.

Couldn't find msdeploy.exe. Follow instructions here: https://learn.microsoft.com/en-us/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy

Événement : Problèmes d'autorisation lors de la migration

Si vous rencontrez des erreurs liées aux autorisations, assurez-vous que vous exécutez l'EB CLI avec des privilèges administratifs. L'exemple suivant affiche un message d'erreur possible.

[ERROR] Access to the path 'C:\inetpub\wwwroot\web.config' is denied.

Événement : Problèmes d'identité du pool d'applications

Si votre application ne démarre pas en raison de problèmes d'identité du pool d'applications, créez un script personnalisé pour configurer les identités du pool d'applications, comme indiqué dansParamètres personnalisés du pool d'applications.

Evénement : erreurs de configuration du certificat SSL

Si les liaisons HTTPS ne fonctionnent pas, assurez-vous d'avoir spécifié un ARN de certificat ACM valide à l'aide du paramètre eb mibrate option--ssl-certificates.

Événement : expiration du délai de création de l'environnement

Si le délai de création de l'environnement est expiré, vérifiez les AWS CloudFormation événements dans la console AWS de gestion pour détecter les échecs de création de ressources spécifiques. Les causes courantes incluent les problèmes de configuration des VPC ou les limites de service.

Obtention de support

Si vous rencontrez des problèmes que vous ne parvenez pas à résoudre, AWS Support collectez les informations suivantes avant de nous contacter :

Pour plus d'informations sur le dépannage d'Elastic Beanstalk, consultez. Résolution des problèmes liés à votre environnement Elastic Beanstalk