Surveillez la progression de la pile - AWS CloudFormation

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.

Surveillez la progression de la pile

Cette section décrit comment surveiller un déploiement de stack en cours. CloudFormation fournit une liste chronologique détaillée des événements de déploiement, indiquant la progression et les éventuels problèmes rencontrés au cours du déploiement.

Afficher les événements de la pile (console)

Pour afficher les événements de la pile
  1. Ouvrez le fichier AWS CloudFormation console sur https://console.aws.amazon.com/cloudformation.

  2. Dans la barre de navigation en haut de l'écran, choisissez Région AWS vous avez créé le stack in.

  3. Sur la page Stacks de la CloudFormation console, sélectionnez le nom de la pile. CloudFormation affiche les détails de la pile sélectionnée.

  4. Choisissez l'onglet Événements pour afficher les événements CloudFormation de pile générés pour votre pile.

CloudFormation actualise automatiquement les événements de la pile toutes les minutes. CloudFormation Affiche également le badge Nouveaux événements disponibles lorsque de nouveaux événements de pile se produisent. Cliquez sur l'icône d'actualisation pour charger ces événements dans la liste. En regardant les événements de création de la pile, vous pouvez comprendre la séquence d'événements qui conduit à sa création (ou à son échec, si vous êtes en phase de débogage).

Lors de la création de votre pile, elle est répertoriée sur la page Stacks avec un statut deCREATE_IN_PROGRESS. Une fois que votre pile a été créée avec succès, son statut passe àCREATE_COMPLETE.

Pour plus d’informations, consultez Comprendre les événements de création de CloudFormation piles et Surveiller la progression d'une mise à jour de la pile.

Afficher les événements de la pile (AWS CLI)

Vous pouvez également utiliser la describe-stack-eventscommande lors de la création de la pile pour afficher les événements tels qu'ils sont signalés.

La describe-stack-events commande suivante décrit les événements de la myteststack pile.

aws cloudformation describe-stack-events --stack-name myteststack

Voici un exemple de réponse.

{ "StackEvents": [ { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "af67ef60-0b8f-11e3-8b8a-500150b352e0", "ResourceStatus": "CREATE_COMPLETE", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2013-08-23T01:02:30.070Z", "StackName": "myteststack", "PhysicalResourceId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0", "LogicalResourceId": "myteststack" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_COMPLETE-1377219748025", "ResourceStatus": "CREATE_COMPLETE", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:28.025Z", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w", "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219746688", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:26.688Z", "ResourceStatusReason": "Resource creation Initiated", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w", "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219743862", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:23.862Z", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": null, "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "a69469e0-0b8f-11e3-8b8a-500150b352e0", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2013-08-23T01:02:15.422Z", "ResourceStatusReason": "User Initiated", "StackName": "myteststack", "PhysicalResourceId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0", "LogicalResourceId": "myteststack" } ] }

Les événements les plus récents apparaissent en premier. Le tableau suivant décrit les champs renvoyés par la commande describe-stack-events :

Champ Description
EventId

Identifiant de l'événement.

StackName

Nom de la pile à laquelle l'événement correspond.

StackId

Identifiant de la pile à laquelle l'événement correspond.

LogicalResourceId

Identifiant logique de la ressource.

PhysicalResourceId

Identifiant physique de la ressource.

ResourceProperties

Propriétés de la ressource.

ResourceType

Type de ressource.

Timestamp

Moment où l'événement est survenu.

ResourceStatus

Le statut de la ressource, qui peut être l'un des codes d'état suivants : CREATE_COMPLETE CREATE_FAILED CREATE_IN_PROGRESS | DELETE_COMPLETE | DELETE_FAILED | DELETE_IN_PROGRESS | DELETE_SKIPPED | IMPORT_COMPLETE | IMPORT_IN_PROGRESS | IMPORT_ROLLBACK_COMPLETE | IMPORT_ROLLBACK_FAILED | IMPORT_ROLLBACK_IN_PROGRESS | REVIEW_IN_PROGRESS ROLLBACK_COMPLETE | ROLLBACK_FAILED | ROLLBACK_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_FAILED | UPDATE_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_IN_PROGRESS

L'état DELETE_SKIPPED s'applique aux ressources dont l'attribut de la politique de suppression correspond à « retain ».

DetailedStatus

État détaillé de la pile. S'il CONFIGURATION_COMPLETE est présent, la phase de configuration des ressources de la pile est terminée et la stabilisation des ressources est en cours.

ResourceStatusReason

Plus d'informations sur cet état.

Codes d'état de la pile

Le tableau suivant décrit les codes d'état d'une pile :

État de la pile et statut détaillé facultatif Description

CREATE_COMPLETE

Réussite de la création d'une ou de plusieurs piles.

CREATE_IN_PROGRESS

Création en cours d'une ou de plusieurs piles.

CREATE_FAILED

Échec de la création d'une ou de plusieurs piles. Affichez les événements de la pile pour voir les messages d'erreur associés. Les raisons possibles d'un échec de création incluent des autorisations insuffisantes pour utiliser toutes les ressources de la pile, des valeurs de paramètres rejetées par un AWS service, ou un délai d'attente lors de la création de ressources.

DELETE_COMPLETE

Réussite de la suppression d'une ou de plusieurs piles. Les piles supprimées sont conservées et consultables pendant 90 jours.

DELETE_FAILED

Échec de la suppression d'une ou de plusieurs piles. Comme la suppression a échoué, certaines ressources sont peut-être encore en cours d'exécution. Cependant, vous ne pouvez pas utiliser ni mettre à jour la pile. Supprimez la pile à nouveau ou consultez les événements correspondants pour voir les messages d'erreur associés.

DELETE_IN_PROGRESS

Suppression en cours d'une ou de plusieurs piles.

REVIEW_IN_PROGRESS

Création continue d'une ou de plusieurs piles avec un StackId attendu, mais sans aucun modèle ni ressource.
Important

Une pile associée à ce code de statut est comptabilisée dans le nombre maximal possible de piles.

ROLLBACK_COMPLETE

Réussite de la suppression d'une ou de plusieurs piles après un échec de création ou après l'annulation explicite de la création de la pile. La pile revient à son état de fonctionnement précédent. Toutes les ressources qui ont été créées au cours de l'action de création de la pile sont supprimées.

Ce statut existe uniquement après un échec de création de la pile. Il signifie que toutes les opérations de la pile partiellement créée ont été correctement nettoyées. Dans ce cas-là, seule une opération de suppression peut être effectuée.

ROLLBACK_FAILED

Échec de la suppression d'une ou de plusieurs piles après un échec de création ou après l'annulation explicite de la création de la pile. Supprimez la pile ou consultez les événements correspondants pour voir les messages d'erreur associés.

ROLLBACK_IN_PROGRESS

Suppression en cours d'une ou de plusieurs piles après un échec de création ou après l'annulation explicite de la création de la pile.

UPDATE_COMPLETE

Réussite de la mise à jour d'une ou de plusieurs piles.

UPDATE_COMPLETE_CLEANUP_IN_PROGRESS

Suppression en cours d'anciennes ressources pour une ou plusieurs piles après une mise à jour réussie. Pour les mises à jour de pile qui nécessitent le remplacement de ressources, CloudFormation créez d'abord les nouvelles ressources, puis supprimez les anciennes ressources afin de réduire les interruptions de votre pile. Dans cet état, la pile a été mise à jour et est utilisable, mais les anciennes ressources CloudFormation sont toujours supprimées.

UPDATE_FAILED

Réussite de la mise à jour d'une ou de plusieurs piles. Affichez les événements de la pile pour voir les messages d'erreur associés.

UPDATE_IN_PROGRESS

Mise à jour en cours d'une ou de plusieurs piles.

UPDATE_ROLLBACK_COMPLETE

Réussite de la restauration de l'état de fonctionnement d'une ou plusieurs piles après un échec de mise à jour.

UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS

Suppression en cours des nouvelles ressources d'une ou de plusieurs piles après un échec de mise à jour. Dans cet état, la pile a été rétablie à son état de fonctionnement précédent et est utilisable, mais CloudFormation les nouvelles ressources créées lors de la mise à jour de la pile sont toujours supprimées.

UPDATE_ROLLBACK_FAILED

Échec de la restauration de l'état de fonctionnement d'une ou plusieurs piles après un échec de mise à jour. Dans ce cas là, vous pouvez supprimer la pile ou poursuivre la restauration. Vous devrez peut-être corriger les erreurs avant que votre pile puisse revenir à un état de fonctionnement. Ou bien, vous pouvez contacter AWS Support pour rétablir l'état utilisable de la pile.

UPDATE_ROLLBACK_IN_PROGRESS

Restauration en cours de l'état de fonctionnement d'une ou plusieurs piles après un échec de mise à jour.

IMPORT_IN_PROGRESS

L'opération d'importation est en cours.

IMPORT_COMPLETE

L'opération d'importation a été exécutée avec succès pour toutes les ressources de la pile qui prennent en charge resource import.

IMPORT_ROLLBACK_IN_PROGRESS

L'importation sera restaurée à la configuration précédente du modèle.

IMPORT_ROLLBACK_FAILED

L'opération de restauration de l'importation a échoué pour au moins une ressource de la pile. Les résultats seront disponibles pour les ressources importées CloudFormation avec succès.

IMPORT_ROLLBACK_COMPLETE

L'importation a été restaurée avec succès à la configuration du modèle précédente.