Restaurer votre pile CloudFormation en cas de dépassement d’alarme à l’aide de déclencheurs de restauration - 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.

Restaurer votre pile CloudFormation en cas de dépassement d’alarme à l’aide de déclencheurs de restauration

Grâce aux déclencheurs de restauration, vous pouvez demander à CloudFormation de surveiller l’état de votre application pendant la création et la mise à jour de la pile, et de restaurer cette opération si l’application dépasse le seuil des alarmes que vous avez spécifié. Pour chaque déclencheur de restauration que vous créez, vous spécifiez l'alarme CloudWatch que CloudFormation doit surveiller. CloudFormation surveille les alarmes spécifiées pendant l'opération de création ou de mise à jour de la pile, et pour la quantité de temps spécifiée, après que toutes les ressources ont été déployées. Si l'une des alarmes passe à l'état ALARM pendant l'opération sur la pile ou la période de surveillance, CloudFormation annule la totalité de l'opération sur la pile.

Vous pouvez définir une durée de surveillance comprise entre la valeur par défaut 0 et 180 minutes. Pendant cette période, CloudFormation surveille tous les déclencheurs de restauration après que l'opération de création ou de mise à jour de la pile a déployé toutes les ressources nécessaires. Si l'une des alarmes passe à l'état ALARM pendant l'opération sur la pile ou cette période de surveillance, CloudFormation annule la totalité de l'opération sur la pile. Ensuite, pour les opérations de mise à jour, si la période de surveillance expire sans qu'aucune alarme ne passe à l'état ALARM, CloudFormation poursuit pour se débarrasser des anciennes ressources comme à l'ordinaire. Si vous définissez une période de surveillance, mais ne spécifiez pas de déclencheurs de restauration, CloudFormation continue d'attendre la période spécifiée avant de nettoyer les anciennes ressources pour les opérations de mise à jour. Vous pouvez utiliser cette période de surveillance pour effectuer toute validation manuelle de pile souhaitée et annuler manuellement la création de la pile ou sa mise à jour, si nécessaire. Si vous définissez une surveillance de 0 minute, CloudFormation continue de surveiller les déclencheurs de restauration pendant les opérations de création et de mise à jour de la pile, et restaure l'opération su une alarme passe à l'état ALARM. Ensuite, pour les opérations de mise à jour sans alarme de violation, la suppression des anciennes ressources commence immédiatement après que l'opération est terminée.

Par défaut, CloudFormation n'annule les opérations de pile que si une alarme passe à l'état ALARM et non à l'état INSUFFICIENT_DATA. Pour que CloudFormation restaure l'opération de pile si une alarme passe également à l'état INSUFFICIENT_DATA, modifiez l'alarme CloudWatch afin de traiter les données manquantes comme breaching. Pour plus d’informations, consultez Configuration de la manière dont les alarmes CloudWatch traitent les données manquantes dans le Guide de l’utilisateur Amazon CloudWatch.

CloudFormation ne surveille pas les déclencheurs de restauration quand il restaure une pile pendant une opération de mise à jour.

Vous pouvez ajouter un maximum de 5 déclencheurs de restauration. Pour ajouter un déclencheur de restauration, spécifiez l'Amazon Resource Name (ARN) de l'alarme CloudWatch. Actuellement, les types AWS::CloudWatch::Alarm et AWS::CloudWatch::CompositeAlarm peuvent être utilisés comme déclencheurs de restauration. Pour plus d’informations sur les alarmes CloudWatch, consultez Utilisation des alarmes CloudWatch dans le Guide de l’utilisateur Amazon CloudWatch.

Si une alarme CloudWatch est manquante, la totalité de l'opération sur la pile échoue et est restaurée.

Veuillez noter que l’accès à CloudWatch nécessite des informations d’identification. Ces informations d'identification doivent avoir des autorisations d'accès aux ressources AWS, telles que la récupération des données des métriques CloudWatch sur vos ressources. Pour plus d’informations, consultez Authentification et contrôle d’accès pour CloudWatch dans le Guide de l’utilisateur Amazon CloudWatch.

Ajouter des déclencheurs de restauration lors de la création ou de la mise à jour d’une pile

Pour ajouter des déclencheurs de restauration lors de la création ou de la mise à jour d’une pile (console)
  1. Lors de la création ou de la mise à jour d’une pile, sur la page Configurer les options de la pile, sous Options avancées, développez la section Configuration de restauration.

  2. Saisissez une durée de surveillance comprise entre 0 et 180 minutes. La valeur par défaut est  0.

  3. Spécifiez l’ARN de l’alarme CloudWatch ou de l’alarme composite que vous voulez utiliser comme déclencheur de restauration, puis sélectionnez Ajouter l’ARN de l’alarme CloudWatch.

    Par exemple, voici un ARN pour une alarme CloudWatch ou une alarme composite, arn:aws:cloudwatch:us-east-1:123456789012:alarm:MyAlarmName.

  4. Sélectionnez Suivant et vérifiez les détails de votre pile.

  5. Lorsque vous êtes prêt, sélectionnez Soumettre pour créer ou mettre à jour la pile.

Pour ajouter des déclencheurs de restauration lors de la création ou de la mise à jour d’une pile (AWS CLI)

Utilisez la commande create-stack ou update-stack avec l’option --rollback-configuration.

Par exemple, la commande update-stack suivante définit MyCompositeAlarm comme déclencheur de restauration avec une période de surveillance de 5 minutes :

aws cloudformation update-stack --stack-name MyStack \ --use-previous-template \ --rollback-configuration \ "RollbackTriggers=[{Arn=arn:aws:cloudwatch:us-east-1:123456789012:alarm:MyCompositeAlarm,Type=AWS::CloudWatch::CompositeAlarm}],MonitoringTimeInMinutes=5"

Ajouter des déclencheurs de restauration à un jeu de modifications

Pour ajouter des déclencheurs de restauration à un jeu de modifications (console)

  1. Lors de la création d’un jeu de modifications, sur la page Configurer les options de pile, sous Options avancées, développez la section Configuration de restauration.

  2. Saisissez une durée de surveillance comprise entre 0 et 180 minutes. La valeur par défaut est  5.

  3. Spécifiez l’ARN de l’alarme CloudWatch ou de l’alarme composite que vous voulez utiliser comme déclencheur de restauration, puis sélectionnez Ajouter l’ARN de l’alarme CloudWatch.

    Par exemple, voici un ARN pour une alarme CloudWatch ou une alarme composite, arn:aws:cloudwatch:us-east-1:123456789012:alarm:MyAlarmName.

  4. Sélectionnez Suivant et vérifiez les détails de votre jeu de modifications.

  5. Lorsque vous êtes prêt, sélectionnez Créer un jeu de modifications pour créer l’ensemble de modifications.

Pour ajouter des déclencheurs de restauration à un ensemble de modifications (AWS CLI)

Utilisez la commande create-change-set avec l’option --rollback-configuration.

Afficher les déclencheurs de restauration pour une pile

Pour afficher les déclencheurs de restauration d'une pile, veuillez consulter la section Configuration de la restauration.

  1. Sur la page Piles, choisissez la pile que vous voulez afficher dans la liste de gauche.

  2. Dans l’onglet Informations sur la pile, développez la section Configuration de restauration pour afficher les déclencheurs de restauration.

Afficher les déclencheurs de restauration pour un jeu de modifications

Pour afficher les déclencheurs de restauration d'un jeu de modifications, veuillez consulter la section Configuration de la restauration.

  1. Sur la page Piles, choisissez la pile que vous voulez afficher dans la liste de gauche.

  2. Sélectionnez l’onglet Jeux de modifications, puis sélectionnez le jeu de modifications que vous voulez afficher.

  3. Sélectionnez l’onglet Entrée et affichez la section Configuration de restauration.