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.
Utiliser les modules du registre CloudFormation privé
Cette rubrique explique comment utiliser les modules dans les CloudFormation modèles. 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 CloudFormation registre 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, veuillez consulter CloudFormation concepts de registre.
-
Incluez-le dans votre modèle : ajoutez le module à la Resources référence de syntaxe de section pour les CloudFormation modèles section de votre CloudFormation modèle, comme vous le feriez avec d'autres ressources. Vous devrez également fournir toutes les propriétés requises pour le module.
-
Création ou mise à jour de la pile : lorsque vous lancez une opération de pile, CloudFormation génère un modèle traité qui transforme tous les modules inclus en 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, veuillez consulter Mettre à jour CloudFormation les piles à l'aide d'ensembles 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 individuelleResourceA, ainsi qu'un module,ModuleParent. Ce module contient deux ressources, ResourceB etResourceC, en plus d'un module imbriqué,ModuleChild. ModuleChildcontient une seule ressource,ResourceD. Si vous créez une pile à partir de ce modèle, CloudFormation traitez le modèle et associez les modules aux ressources appropriées. La pile résultante comporte quatre ressources : ResourceAResourceB,ResourceC, etResourceD.
CloudFormation permet de savoir quelles ressources d'une pile ont été 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
