Résoudre les problèmes liés à Amazon EC2 Auto Scaling

1. Effectuez l’une des actions suivantes :

   • Appelez la delete-deployment-groupcommande pour supprimer le groupe de déploiement associé au groupe Auto Scaling à l'origine du délai d'expiration du rythme cardiaque.

   • Appelez la update-deployment-groupcommande avec une liste vide non nulle de noms de groupes Auto Scaling pour détacher tous les hooks du cycle de vie Auto CodeDeploy Scaling gérés par Auto Scaling.

     Par exemple, entrez la AWS CLI commande suivante :

     aws deploy update-deployment-group --application-name my-example-app --current-deployment-group-name my-deployment-group --auto-scaling-groups

     Autre exemple, si vous utilisez le CodeDeploy API avec Java, appelez UpdateDeploymentGroup et réglez autoScalingGroups surnew ArrayList<String>(). Cela permet autoScalingGroups de définir une liste vide et de supprimer la liste existante. Ne l'utilisez pasnull, ce qui est le cas par défaut, car cela reste tel autoScalingGroups quel, ce qui n'est pas ce que vous voulez.

   Examinez la sortie de l'appel. Si la sortie contient une hooksNotCleanedUp structure avec une liste des hooks du cycle de vie d'Amazon EC2 Auto Scaling, il reste des hooks du cycle de vie.

2. Appelez la describe-lifecycle-hookscommande en spécifiant le nom du groupe Amazon EC2 Auto Scaling associé aux EC2 instances dont le lancement a échoué. Dans le résultat, recherchez l'un des éléments suivants :

   • Les noms des hooks du cycle de vie d'Amazon EC2 Auto Scaling correspondent à la hooksNotCleanedUp structure que vous avez identifiée à l'étape 1.

   • Noms des hooks du cycle de vie Amazon EC2 Auto Scaling contenant le nom du groupe de déploiement associé au groupe Auto Scaling défaillant.

   • Noms des hooks du cycle de vie d'Amazon EC2 Auto Scaling susceptibles d'avoir provoqué le délai d'expiration du CodeDeploy déploiement.

3. Si un hook appartient à l'une des catégories répertoriées à l'étape 2, appelez la delete-lifecycle-hookcommande pour le supprimer. Spécifiez le groupe Amazon EC2 Auto Scaling et le hook du cycle de vie dans l'appel.

   Important

   Supprimez uniquement les hooks qui posent problème, comme indiqué à l'étape 2. Si vous supprimez des hooks viables, vos déploiements risquent d' CodeDeploy échouer ou de ne pas être en mesure de déployer les révisions de votre application sur EC2 des instances évolutives.

4. Appelez la create-deployment-groupcommande update-deployment-groupou avec les noms de groupes Auto Scaling souhaités. CodeDeployréinstalle les hooks Auto Scaling avec de nouveaux. UUIDs

1. Appelez la describe-lifecycle-hookscommande en spécifiant le nom du groupe Amazon EC2 Auto Scaling associé au groupe de déploiement dans CodeDeploy. Dans la sortie, dans la liste LifecycleHooks, notez chaque valeur LifecycleHookName.

2. Appelez la get-deployment-groupcommande en spécifiant le nom du groupe de déploiement associé au groupe Amazon EC2 Auto Scaling. Dans la sortie, dans la autoScalingGroups liste, recherchez chaque élément dont le nom correspond au nom du groupe Amazon EC2 Auto Scaling, puis notez la hook valeur correspondante.

1. Si des noms de hooks de cycle de vie figurent dans la sortie de la commande describe-lifecycle-hooks qui ne figurent pas également dans la sortie de la commande get-deployment-group, procédez comme suit :

   1. Pour chaque nom de hook du cycle de vie indiqué dans la sortie de describe-lifecycle-hooks commande, appelez la delete-lifecycle-hookcommande.

   2. Appelez la update-deployment-groupcommande en spécifiant le nom du groupe Amazon EC2 Auto Scaling d'origine. CodeDeploy crée de nouveaux hooks de cycle de vie de remplacement dans le groupe Amazon EC2 Auto Scaling et associe les crochets de cycle de vie au groupe de déploiement. Les déploiements automatiques devraient maintenant reprendre à mesure que de nouvelles instances sont ajoutées au groupe Amazon EC2 Auto Scaling.

2. Si des noms de hooks de cycle de vie figurent dans la sortie de la commande get-deployment-group, mais ne figurent pas dans la sortie de la commande describe-lifecycle-hooks, procédez comme suit :

   1. Appelez la update-deployment-groupcommande, mais ne spécifiez pas le nom du groupe Amazon EC2 Auto Scaling d'origine.

   2. Appelez à nouveau la update-deployment-group commande, mais spécifiez cette fois le nom du groupe Amazon EC2 Auto Scaling d'origine. CodeDeploy recrée les hooks du cycle de vie manquants dans le groupe Amazon EC2 Auto Scaling. Les déploiements automatiques devraient maintenant reprendre à mesure que de nouvelles instances sont ajoutées au groupe Amazon EC2 Auto Scaling.

Pour résoudre l'erreur s'il n'y a aucune instance dans l'état InService

1. Dans la EC2 console Amazon, vérifiez le paramètre Capacité souhaitée. S'il est égal à zéro, définissez-le sur un nombre positif. Attendez que l'instance existeInService, ce qui signifie que le déploiement a réussi. Vous avez résolu le problème et pouvez ignorer les étapes restantes de cette procédure de dépannage. Pour plus d'informations sur la définition du paramètre Desired Capacity, consultez la section Définition des limites de capacité sur votre groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

2. Si Auto Scaling continue d'essayer de lancer de nouvelles EC2 instances pour atteindre la capacité souhaitée mais ne parvient jamais à le faire évoluer, cela est généralement dû à un échec du hook du cycle de vie d'Auto Scaling. Résolvez ce problème comme suit :

   1. Pour savoir quel événement Auto Scaling Lifecycle Hook échoue, consultez la section Vérification d'une activité de dimensionnement pour un groupe Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

   2. Si le nom du hook défaillant estCodeDeploy-managed-automatic-launch-deployment-hook-DEPLOYMENT_GROUP_NAME, accédez au groupe de déploiement CodeDeploy, recherchez le groupe de déploiement et recherchez le déploiement ayant échoué lancé par Auto Scaling. Déterminez ensuite pourquoi le déploiement a échoué.

   3. Si vous comprenez pourquoi le déploiement a échoué (par exemple, des CloudWatch alarmes se sont produites) et que vous pouvez résoudre le problème sans modifier la révision, faites-le maintenant.

   4. Si, après enquête, vous déterminez que CodeDeploy la dernière révision réussie n'est plus saine et qu'il n'y a aucune instance saine dans votre groupe Auto Scaling, vous êtes dans un scénario de blocage du déploiement. Pour résoudre ce problème, vous devez corriger la mauvaise CodeDeploy révision en supprimant temporairement le hook CodeDeploy du cycle de vie du groupe Auto Scaling, puis en le réinstallant et en redéployant une nouvelle (bonne) révision. Pour obtenir des instructions, consultez :

      • To fix the deployment deadlock issue (CLI)

      • To fix the deployment deadlock issue (console)

Pour résoudre le problème de blocage du déploiement () CLI

1. (Facultatif) Bloquez les pipelines CI/CD à l'origine de l' CodeDeploy erreur afin d'éviter des déploiements inattendus pendant que vous résolvez ce problème.

2. Prenez note de votre DesiredCapacityparamètre Auto Scaling actuel :

   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name ASG_NAME

   Vous devrez peut-être revenir à ce chiffre à la fin de cette procédure.

3. Définissez le DesiredCapacityparamètre Auto Scaling sur1. Cette option est facultative si la capacité souhaitée était supérieure 1 à la capacité initiale. En le réduisant à1, l'instance mettra moins de temps à provisionner et à déployer ultérieurement, ce qui accélère le dépannage. Si la capacité souhaitée par Auto Scaling était initialement définie sur0, vous devez l'augmenter à1. Cela est obligatoire.

   en tant que mise à l'échelle automatique set-desired-capacity -- auto-scaling-group-name ASG_NAME --capacité souhaitée 1

   Note

   Les étapes restantes de cette procédure supposent que vous avez défini votre valeur DesiredCapacitysur1.

   À ce stade, Auto Scaling tente d'effectuer une mise à l'échelle jusqu'à une seule instance. Ensuite, comme le hook CodeDeploy ajouté est toujours présent, CodeDeploy essaie de se déployer ; le déploiement échoue ; Auto Scaling annule l'instance ; et Auto Scaling essaie de relancer une instance pour atteindre la capacité souhaitée d'une instance, mais échoue à nouveau. Vous êtes dans une boucle d'annulation/relance.

4. Désenregistrez le groupe Auto Scaling du groupe de déploiement :

   Avertissement

   La commande suivante lancera une nouvelle EC2 instance sans logiciel. Avant d'exécuter la commande, assurez-vous qu'une InService instance Auto Scaling n'exécutant aucun logiciel est acceptable. Par exemple, assurez-vous que l'équilibreur de charge associé à l'instance n'envoie pas de trafic vers cet hôte sans logiciel.

   Important

   Utilisez la CodeDeploy commande ci-dessous pour retirer le crochet. Ne supprimez pas le crochet via le service Auto Scaling, car le retrait ne sera pas reconnu par CodeDeploy.

   aws deploy update-deployment-group --application-name APPLICATION_NAME --current-deployment-group-name DEPLOYMENT_GROUP_NAME --auto-scaling-groups

   Après avoir exécuté cette commande, voici ce qui se produit :

   1. CodeDeploy désenregistre le groupe Auto Scaling du groupe de déploiement.

   2. CodeDeploy supprime le hook du cycle de vie Auto Scaling du groupe Auto Scaling.

   3. Le hook à l'origine de l'échec du déploiement n'étant plus présent, Auto Scaling annule l'EC2instance existante et en lance immédiatement une nouvelle pour l'adapter à la capacité souhaitée. La nouvelle instance devrait bientôt passer à InService l'état. La nouvelle instance n'inclut aucun logiciel.

5. Attendez que l'EC2instance entre dans l'InServiceétat. Pour vérifier son état, utilisez la commande suivante :

   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-names ASG_NAME --query AutoScalingGroups[0].Instances[*].LifecycleState

6. Ajoutez le hook à nouveau à l'EC2instance :

   Important

   Utilisez la CodeDeploy commande ci-dessous pour ajouter le crochet. N'utilisez pas le service Auto Scaling pour ajouter le hook, car l'ajout ne sera pas reconnu par CodeDeploy.

   aws deploy update-deployment-group --application-name APPLICATION_NAME --current-deployment-group-name DEPLOYMENT_GROUP_NAME --auto-scaling-groups ASG_NAME

   Après avoir exécuté cette commande, voici ce qui se produit :

   1. CodeDeploy réinstalle le hook du cycle de vie Auto Scaling sur l'instance EC2

   2. CodeDeploy réenregistre le groupe Auto Scaling auprès du groupe de déploiement.

7. Créez un déploiement à l'échelle du parc à l'aide de l'Amazon S3 ou de GitHub la version dont vous savez qu'elle est saine et que vous souhaitez utiliser.

   Par exemple, si la révision est un fichier .zip dans un compartiment Amazon S3 appelé my-revision-bucket avec une clé d'objet dehttpd_app.zip, entrez la commande suivante :

   aws deploy create-deployment --application-name APPLICATION_NAME --deployment-group-name DEPLOYMENT_GROUP_NAME --revision "revisionType=S3,s3Location={bucket=my-revision-bucket,bundleType=zip,key=httpd_app.zip}"

   Comme il existe désormais une InService instance dans le groupe Auto Scaling, ce déploiement devrait fonctionner et le message d'erreur « Le déploiement a échoué car aucune instance n'a été trouvée pour votre groupe de déploiement » ne devrait plus s'afficher.

8. Une fois le déploiement réussi, redimensionnez votre groupe Auto Scaling à sa capacité initiale, si vous l'avez déjà redimensionné :

   aws autoscaling set-desired-capacity --auto-scaling-group-name ASG_NAME --desired-capacity ORIGINAL_CAPACITY

Pour résoudre le problème de blocage du déploiement (console)

1. (Facultatif) Bloquez les pipelines CI/CD à l'origine de l' CodeDeploy erreur afin d'éviter des déploiements inattendus pendant que vous résolvez ce problème.

2. Accédez à la EC2 console Amazon et prenez note de votre paramètre de capacité Auto Scaling Desired. Vous devrez peut-être revenir à ce chiffre à la fin de cette procédure. Pour plus d'informations sur la recherche de ce paramètre, consultez la section Définition des limites de capacité sur votre groupe Auto Scaling.

3. Définissez le nombre d'EC2instances souhaité comme suit 1 :

   Cette option est facultative si la capacité souhaitée était supérieure 1 à la capacité initiale. En le réduisant à1, l'instance mettra moins de temps à provisionner et à déployer ultérieurement, ce qui accélère le dépannage. Si votre capacité Auto Scaling Desired était initialement définie sur0, vous devez l'augmenter à1. Cela est obligatoire.

   Note

   Les étapes restantes de cette procédure supposent que vous avez défini la capacité souhaitée sur1.

   1. Ouvrez la EC2 console Amazon à l'adresse https://console.aws.amazon.com/ec2/et choisissez Auto Scaling Groups dans le volet de navigation.

   2. Choisissez la région appropriée.

   3. Accédez au groupe Auto Scaling qui pose problème.

   4. Dans Détails du groupe, choisissez Modifier.

   5. Réglez la capacité souhaitée sur1.

   6. Choisissez Mettre à jour.

4. Désenregistrez le groupe Auto Scaling du groupe de déploiement :

   Avertissement

   Les sous-étapes suivantes lanceront une nouvelle EC2 instance sans logiciel. Avant d'exécuter la commande, assurez-vous qu'une InService instance Auto Scaling n'exécutant aucun logiciel est acceptable. Par exemple, assurez-vous que l'équilibreur de charge associé à l'instance n'envoie pas de trafic vers cet hôte sans logiciel.

   1. Ouvrez la CodeDeploy console à l'adresse https://console.aws.amazon.com/codedeploy/.

   2. Choisissez la région appropriée.

   3. Dans le volet de navigation, choisissez Applications.

   4. Choisissez le nom de votre CodeDeploy application.

   5. Choisissez le nom de votre groupe CodeDeploy de déploiement.

   6. Choisissez Modifier.

   7. Dans Configuration de l'environnement, désélectionnez les groupes Amazon EC2 Auto Scaling.

      Note

      La console ne vous permet pas d'enregistrer la configuration si aucune configuration d'environnement n'est définie. Pour contourner cette vérification, ajoutez temporairement un tag de EC2 ou On-premises dont vous savez qu'il ne sera résolu à aucun hôte. Pour ajouter une balise, sélectionnez les EC2instances Amazon ou les instances sur site, puis ajoutez une balise Key of EC2 orOn-premises. Vous pouvez laisser le tag Value vide.

   8. Sélectionnez Enregistrer les modifications.

      Une fois ces sous-étapes terminées, voici ce qui se produit :

      1. CodeDeploy désenregistre le groupe Auto Scaling du groupe de déploiement.

      2. CodeDeploy supprime le hook du cycle de vie Auto Scaling du groupe Auto Scaling.

      3. Le hook à l'origine de l'échec du déploiement n'étant plus présent, Auto Scaling annule l'EC2instance existante et en lance immédiatement une nouvelle pour l'adapter à la capacité souhaitée. La nouvelle instance devrait bientôt passer à InService l'état. La nouvelle instance n'inclut aucun logiciel.

5. Attendez que l'EC2instance entre dans l'InServiceétat. Pour vérifier son état :

   1. Ouvrez la EC2 console Amazon à l'adresse https://console.aws.amazon.com/ec2/.

   2. Dans le panneau de navigation, choisissez Groupes Auto Scaling.

   3. Choisissez votre groupe Auto Scaling.

   4. Dans le volet de contenu, choisissez l'onglet Instance Management.

   5. Sous Instances, assurez-vous que la colonne Lifecycle est indiquée à InServicecôté de l'instance.

6. Réenregistrez le groupe Auto Scaling auprès du groupe de CodeDeploy déploiement en utilisant la même méthode que celle que vous avez utilisée pour le supprimer :

   1. Ouvrez la CodeDeploy console à l'adresse https://console.aws.amazon.com/codedeploy/.

   2. Choisissez la région appropriée.

   3. Dans le volet de navigation, choisissez Applications.

   4. Choisissez le nom de votre CodeDeploy application.

   5. Choisissez le nom de votre groupe CodeDeploy de déploiement.

   6. Choisissez Modifier.

   7. Dans Configuration de l'environnement, sélectionnez les groupes Amazon EC2 Auto Scaling et sélectionnez votre groupe Auto Scaling dans la liste.

   8. Sous EC2Instances Amazon ou Instances sur site, recherchez le tag que vous avez ajouté et supprimez-le.

   9. Décochez la case située à côté des EC2instances Amazon ou des instances sur site.

   10. Sélectionnez Enregistrer les modifications.

   Cette configuration réinstalle le hook du cycle de vie dans le groupe Auto Scaling.

7. Créez un déploiement à l'échelle du parc à l'aide de l'Amazon S3 ou de GitHub la version dont vous savez qu'elle est saine et que vous souhaitez utiliser.

   Par exemple, si la révision est un fichier .zip dans un compartiment Amazon S3 appelé my-revision-bucket avec une clé d'objet dehttpd_app.zip, procédez comme suit :

   1. Dans la CodeDeploy console, sur la page Groupe de déploiement, choisissez Créer un déploiement.

   2. Pour Type de révision, choisissez Mon application est stockée dans Amazon S3.

   3. Pour Emplacement de la révision, sélectionnezs3://my-revision-bucket/httpd_app.zip.

   4. Pour le type de fichier de révision, sélectionnez.zip.

   5. Choisissez Créer un déploiement.

   Comme il existe désormais une InService instance dans le groupe Auto Scaling, ce déploiement devrait fonctionner et le message d'erreur « Le déploiement a échoué car aucune instance n'a été trouvée pour votre groupe de déploiement » ne devrait plus s'afficher.

8. Une fois le déploiement réussi, redimensionnez votre groupe Auto Scaling à sa capacité initiale, si vous l'avez déjà redimensionné :

   1. Ouvrez la EC2 console Amazon à l'adresse https://console.aws.amazon.com/ec2/et choisissez Auto Scaling Groups dans le volet de navigation.

   2. Choisissez la région appropriée.

   3. Accédez à votre groupe Auto Scaling.

   4. Dans Détails du groupe, choisissez Modifier.

   5. Rétablissez la capacité souhaitée à sa valeur initiale.

   6. Choisissez Mettre à jour.