Sections du modèle CloudFormation

Chaque modèle CloudFormation se compose d’une ou plusieurs sections, chacune ayant un objectif spécifique.

La section Resources est obligatoire dans chaque modèle CloudFormation et constitue le cœur du modèle. Cette section spécifie les ressources de la pile et leurs propriétés, telles qu’une instance Amazon EC2 ou un compartiment Amazon S3. Chaque ressource est définie avec un identifiant logique unique, un type et des détails de configuration spécifiques.

La section Parameters, bien que facultative, joue un rôle important dans la flexibilité des modèles. Elle permet aux utilisateurs de transmettre des valeurs au moment de l’exécution lors de la création ou de la mise à jour d’une pile. Ces paramètres peuvent être référencés dans les sections Resources et Outputs, ce qui permet une personnalisation sans modifier le modèle lui-même. Par exemple, vous pouvez utiliser des paramètres pour spécifier des types d’instances ou des paramètres d’environnement qui varient d’un déploiement à l’autre.

La section Outputs, également facultative, définit les valeurs qui sont renvoyées lors de l’affichage des propriétés d’une pile. Les sorties fournissent des informations utiles telles que les identifiants de ressources ou les URL, qui peuvent être exploitées à des fins opérationnelles ou pour l’intégration avec d’autres piles. Cette section aide les utilisateurs à récupérer et à utiliser des détails importants sur les ressources créées par le modèle.

D’autres sections facultatives incluent Mappings, qui fonctionne comme des tables de recherche pour gérer les valeurs conditionnelles. Avec les mappages, vous définissez des paires clé-valeur et les utilisez avec la fonction intrinsèque Fn::FindInMap dans les sections Resources et Outputs. Cela est utile dans les scénarios où vous devez ajuster les configurations en fonction de conditions telles que Région AWS ou l’environnement.

Les sections Metadata et Rules, bien que moins couramment utilisées, offrent des fonctionnalités supplémentaires. Metadata peut inclure des informations supplémentaires sur le modèle, tandis que Rules valide un paramètre ou une combinaison de paramètres lors de la création ou de la mise à jour d’une pile, garantissant ainsi qu’ils répondent à des critères spécifiques. La section Conditions améliore encore la flexibilité en contrôlant si certaines ressources sont créées ou si des propriétés se voient attribuer une valeur en fonction de conditions telles que le type d’environnement.

Enfin, la section Transform est utilisée pour appliquer des macros pendant le traitement du modèle. Pour les applications sans serveur (également appelées applications Lambda), elle spécifie la version du modèle d’application sans serveur AWS (AWS SAM) à utiliser. Lorsque vous spécifiez une transformation, vous pouvez utiliser la syntaxe AWS SAM afin de déclarer des ressources dans votre modèle. Le modèle définit la syntaxe que vous pouvez utiliser et comment elle est traitée. Vous pouvez également utiliser la transformation AWS::Include pour inclure des extraits de modèle qui sont stockés séparément du modèle CloudFormation principal.

Les rubriques suivantes fournissent plus d’informations et des exemples d’utilisation de chaque section.