Surveillance de la progression de la mise à jour d'une pile

Pour suivre la progression d'une mise à jour de la pile, vous pouvez consulter ses événements. L'onglet Événements de la console affiche chaque étape majeure de création et de mise à jour de la pile, triée en fonction de l'heure de chaque événement avec les événements les plus récents en haut de la liste.

Événements générés lors d'une mise à jour de pile réussie

Le début du processus de mise à jour de la pile est marqué d'un événement UPDATE_IN_PROGRESS pour la pile :

2011-09-30 09:35 PDT AWS::CloudFormation::Stack MyStack UPDATE_IN_PROGRESS 

Viennent ensuite les événements qui marquent le début et la fin de la mise à jour de chaque ressource qui a été modifiée dans le modèle de mise à jour. Par exemple, la mise à jour d'une ressourceAWS::RDS::DBInstance nommée MyDB entraînerait les entrées suivantes :

2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_COMPLETE
2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS 

L'événement UPDATE_IN_PROGRESS est enregistré lorsqu'il AWS CloudFormation indique que la ressource a commencé à être mise à jour. L'événement UPDATE_COMPLETE est enregistré lorsque la ressource est créée avec succès.

Une AWS CloudFormation fois la pile mise à jour réussie, vous verrez l'événement suivant :

2011-09-30 09:35 PDT AWS::CloudFormation::Stack MyStack UPDATE_COMPLETE 

Important

Lors des opérations de mise à jour de la pile, s'il est CloudFormation nécessaire de remplacer une ressource existante, il crée d'abord une nouvelle ressource, puis supprime l'ancienne ressource. Cependant, dans certains cas, il CloudFormation peut être impossible de supprimer l'ancienne ressource (par exemple, si l'utilisateur n'est pas autorisé à supprimer une ressource d'un type donné).

CloudFormation fait trois tentatives pour supprimer l'ancienne ressource. S'il n'est pas CloudFormation possible de supprimer l'ancienne ressource, elle est supprimée de la pile et continue de mettre à jour la pile. Lorsque la mise à jour de la pile est terminée, CloudFormation un événement de UPDATE_COMPLETE pile est émis, mais inclut un événement indiquant StatusReason qu'une ou plusieurs ressources n'ont pas pu être supprimées. CloudFormation émet également un DELETE_FAILED événement pour la ressource spécifique, avec un correspondant StatusReason fournissant plus de détails sur les raisons de l' CloudFormation échec de la suppression de la ressource.

L'ancienne ressource existe toujours et continuera d'être facturée, mais elle n'est plus accessible via CloudFormation. Pour supprimer l'ancienne ressource, accédez à l'ancienne ressource directement à l'aide de la console ou de l'API du service sous-jacent.

Ceci est également vrai pour les ressources que vous avez retirées du modèle de pile et qui seront donc supprimées de la pile lors de la mise à jour de la pile.

Événements générés en cas d'échec d'une mise à jour de ressource

Si la mise à jour d'une ressource échoue, AWS CloudFormation signale un UPDATE_FAILED événement indiquant la raison de l'échec. Par exemple, si votre modèle de mise à jour spécifiait une modification de propriété qui n'est pas prise en charge par la ressource, telle que la réduction de la taille AllocatedStorage d'une ressource AWS : :RDS : :DBInstance, vous verrez des événements comme ceux-ci :

2011-09-30 09:36 PDT AWS::RDS::DBInstance MyDB UPDATE_FAILED Size cannot be less than current size; requested: 5; current: 10
2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS 

En cas d'échec d'une mise à jour AWS CloudFormation des ressources, restaure toutes les ressources mises à jour lors de la mise à niveau vers leurs configurations antérieures à la mise à jour. Voici un exemple d'événements que vous pouvez voir en cas d'annulation d'une mise à jour :

2011-09-30 09:38 PDT AWS::CloudFormation::Stack MyStack UPDATE_ROLLBACK_COMPLETE
2011-09-30 09:38 PDT AWS::RDS::DBInstance MyDB UPDATE_COMPLETE
2011-09-30 09:37 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS
2011-09-30 09:37 PDT AWS::CloudFormation::Stack MyStack UPDATE_ROLLBACK_IN_PROGRESS The following resource(s) failed to update: [MyDB] 

Pour afficher les événements de la pile à l'aide de la console

1. Dans la console AWS CloudFormation, choisissez la pile que vous avez mise à jour et choisissez l'onglet Events afin d'afficher les événements de la pile.

2. Pour mettre à jour la liste des événements avec les événements les plus récents, cliquez sur le bouton d'actualisation de la AWS CloudFormation console.

Pour afficher les événements de la pile à l'aide de la ligne de commande

• Utilisez la commande aws cloudformation describe-stack-events pour afficher les événements d'une pile.