Utiliser les modules du registre privé CloudFormation
Cette rubrique explique l’utilisation des modules dans les modèles CloudFormation. Considérez les modules comme des ensembles de ressources prédéfinis que vous pouvez ajouter à vos modèles.
Pour utiliser un module, procédez comme suit :
-
Enregistrer le module : vous enregistrez les modules dans le registre CloudFormation en tant qu’extensions privées. Assurez-vous qu’il est enregistré dans la région Compte AWS et dans laquelle vous travaillez. Pour de plus amples informations, consultez Concepts CloudFormation.
-
Incluez-le dans votre modèle : ajoutez le module à la section Resources de votre modèle CloudFormation, comme vous le feriez avec d’autres ressources. Vous devrez également fournir toutes les propriétés requises pour le module.
-
Créer ou mettre à jour la pile : lorsque vous lancez une opération de pile, CloudFormation génère un modèle traité qui résout tous les modules inclus dans les ressources appropriées.
-
Aperçu des modifications : avant d’apporter des modifications, vous pouvez utiliser un ensemble de modifications pour voir quelles ressources seront ajoutées ou modifiées. Pour de plus amples informations, consultez Mettre à jour les piles CloudFormation à l’aide de jeux de modifications.
Prenons l'exemple suivant : Vous disposez d'un modèle qui contient à la fois des ressources et des modules. Le modèle contient une ressource individuelle, ResourceA, ainsi qu’un module, ModuleParent. Ce module contient deux ressources, ResourceB et ResourceC, ainsi qu’un module imbriqué, ModuleChild. ModuleChild contient une seule ressource, ResourceD. Si vous créez une pile à partir de ce modèle, CloudFormation traite le modèle et résout les modules dans les ressources appropriées. La pile obtenue comporte quatre ressources : ResourceA, ResourceB, ResourceC, et ResourceD.
CloudFormation suit les ressources d'une pile créées à partir de modules. Vous pouvez afficher ces informations dans les onglets Événements, Ressources et Écarts pour une pile donnée. Elles sont également comprises dans les prévisualisations des ensembles de modifications.
Les modules se distinguent des ressources d'un modèle, car ils adhèrent à la convention de dénomination en quatre parties suivante, par opposition à la convention typique en trois parties utilisée par les ressources :
organization::service::use-case::MODULE
