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.
AWS CloudFormation Concepts de crochets
La terminologie et les concepts suivants sont essentiels à votre compréhension et à votre utilisation des AWS CloudFormation Hooks :
Crochet
Un Hook contient du code qui est invoqué immédiatement avant la CloudFormation création, la mise à jour ou la suppression de piles ou de ressources spécifiques. Il peut également être invoqué lors d'une opération de création d'un ensemble de modifications. Les Hooks peuvent inspecter le modèle, les ressources ou l'ensemble de modifications qui CloudFormation est sur le point d'être provisionné. De plus, les Hooks peuvent être invoqués immédiatement avant que le Cloud Control ne API crée, ne mette à jour ou ne supprime des ressources spécifiques.
Si un Hook identifie des configurations qui ne sont pas conformes aux directives organisationnelles définies dans votre logique Hook, vous pouvez choisir d'utiliser WARN les utilisateurs ou FAIL d' CloudFormation empêcher le provisionnement de la ressource.
Les crochets présentent les caractéristiques suivantes :
-
Validation proactive : réduit les risques, les frais opérationnels et les coûts en identifiant les ressources non conformes avant leur création, leur mise à jour ou leur suppression.
-
Application automatique : assure l'application dans votre système afin Compte AWS d'empêcher le provisionnement de ressources non conformes par. CloudFormation
Mode de défaillance
Votre logique Hook peut renvoyer un succès ou un échec. Une réponse positive permettra à l'opération de se poursuivre. Une défaillance due à des ressources non conformes peut avoir les conséquences suivantes :
-
FAIL— Arrête l'opération de provisionnement. -
WARN— Permet de poursuivre le provisionnement avec un message d'avertissement.
La création de Hooks en WARN mode est un moyen efficace de surveiller le comportement des Hooks sans affecter les opérations de stack. Activez d'abord le WARN mode Hooks pour comprendre quelles opérations seront affectées. Après avoir évalué les effets potentiels, vous pouvez passer en FAIL mode Hook pour commencer à empêcher les opérations non conformes.
Crochet et cibles
Les cibles Hook spécifient les opérations qu'un Hook évaluera. Il peut s'agir d'opérations sur :
-
Ressources soutenues par CloudFormation (
Resources) -
Modèles de pile (
STACK) -
Ensembles de modifications (
CHANGE_SET) -
Ressources prises en charge par le Cloud Control API (
CLOUD_CONTROL)
Vous définissez une ou plusieurs cibles qui spécifient les opérations les plus larges que le Hook évaluera. Par exemple, vous pouvez créer un ciblage Hook RESOURCES pour cibler toutes les AWS ressources et STACK tous les modèles de stack. Vous pouvez également appliquer des filtres pour réduire la portée du Hook à l'opération exacte que vous souhaitez évaluer. Pour plus d’informations, consultez AWS CloudFormation Filtres de niveau Hooks Stack et AWS CloudFormation Filtres cibles Hooks.
Actions ciblées
L'action cible est le type d'opération qui déclenche un Hook. L'action peut être CREATEUPDATE, ouDELETE.
Note
Lorsque vous utilisez RESOURCE les ciblesSTACK,, et CLOUD_CONTROL Hook, toutes les actions cibles sont applicables. Lorsque vous utilisez des cibles CHANGE_SET Hook, seule l'CREATEaction est applicable.
Manipulateur de crochets
Pour les Hooks personnalisés, il s'agit du code qui gère l'évaluation. Il est associé à un point d'invocation cible et à une action cible qui marquent le point exact où un Hook s'exécute. Vous écrivez des gestionnaires qui hébergent la logique pour ces points spécifiques. Par exemple, un point d'invocation PRE cible avec une action CREATE cible crée un gestionnaire preCreate Hook. Le code du gestionnaire Hook s'exécute lorsqu'un point d'appel cible et un service correspondants exécutent une action cible associée.
Valeurs valides : (preCreate| preUpdate |preDelete)
Important
Les opérations de pile qui se traduisent par le statut de UpdateCleanup n'invoquent pas de Hook. Par exemple, dans les deux scénarios suivants, le preDelete gestionnaire du Hook n'est pas invoqué :
-
la pile est mise à jour après la suppression d'une ressource du modèle.
-
une ressource dont le type de mise à jour est remplacé est supprimée.
