View a markdown version of this page

Mettre à jour CloudFormation les piles à l'aide d'ensembles de modifications - 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.

Mettre à jour CloudFormation les piles à l'aide d'ensembles de modifications

Avant de mettre à jour une pile, il peut être utile de comprendre l’incidence des modifications sur les ressources exécutées. Les jeux de modifications vous permettent de prévisualiser l’impact des modifications proposées sur une pile sur vos ressources en cours d’exécution, y compris l’impact sur les propriétés et les attributs des ressources. Si vos modifications supprimeront ou remplaceront des ressources critiques, CloudFormation apportez les modifications à votre pile uniquement lorsque vous décidez d'exécuter l'ensemble de modifications, ce qui vous permet de décider de poursuivre les modifications proposées ou d'explorer d'autres modifications en créant un autre ensemble de modifications. Vous pouvez créer et gérer des ensembles de modifications à l'aide de la CloudFormation console ou de CloudFormation l'API. AWS CLI

Rubriques
Important

Les ensembles de modifications ne garantissent CloudFormation pas la réussite de la mise à jour d'une pile. Toutefois, la validation préalable au déploiement vérifie les causes de défaillance courantes lors de la création de l'ensemble de modifications, notamment les erreurs de syntaxe des propriétés, les conflits de noms de ressources, les limites de quota de service et d'autres contraintes. Les défaillances dues aux conditions d'exécution (telles que la logique de ressources personnalisée ou les contraintes spécifiques au service) peuvent toujours se produire pendant l'exécution.

Note

Vous pouvez utiliser le mode express avec des ensembles de modifications pour effectuer les opérations de stack plus rapidement. Spécifiez le --deployment-config '{"mode": "EXPRESS"}' paramètre lors de la création d'un ensemble de modifications. Lorsque l'ensemble de modifications est exécuté, CloudFormation applique le mode express et termine les opérations sur les ressources dès que la configuration est appliquée. Pour de plus amples informations, veuillez consulter Mode express.

Vue d'ensemble de modifications

Le schéma suivant résume comment utiliser les jeux de modifications pour mettre à jour une pile :

Schéma illustrant les quatre étapes de mise à jour d'une pile à l'aide d'ensembles de CloudFormation modifications.

  1. Pour créer un jeux de modifications, vous devez soumettre les modifications que vous souhaitez apporter à la pile. Vous pouvez soumettre un modèle de pile modifié ou des valeurs de paramètres d'entrée modifiées. CloudFormation compare votre pile avec les modifications que vous avez soumises pour générer l'ensemble de modifications ; elle n'apporte aucune modification à votre pile pour le moment.

  2. Affichez le jeu de modifications pour identifier les paramètres et les ressources de la pile qui seront modifiés. Par exemple, vous pouvez voir quelles ressources CloudFormation seront ajoutées, modifiées ou supprimées. En outre, vous pouvez voir une comparaison avant-après des propriétés et des attributs des ressources, tels que les balises, qui CloudFormation seront modifiés.

  3. Facultatif : Si vous souhaitez prendre en compte d'autres modifications avant de choisir les changements à apporter, créez des jeux de modifications supplémentaires. La création de plusieurs jeux de modifications vous aide à comprendre et à évaluer l’impact des différentes modifications sur vos ressources et vos propriétés. Vous pouvez créer autant de jeux de modifications que vous le souhaitez.

  4. Exécutez le jeu de modifications qui contient les modifications que vous souhaitez appliquer à votre pile. CloudFormation met à jour votre pile avec ces modifications.

    Note

    Après avoir exécuté une modification, CloudFormation supprime tous les ensembles de modifications associés à la pile car ils ne sont pas applicables à la pile mise à jour.

Vous pouvez également supprimer des jeux de modifications si vous ne souhaitez pas qu'ils soient appliqués.