CloudFormation sections du modèle

Chaque CloudFormation modèle comprend une ou plusieurs sections, chacune ayant un objectif spécifique.

La section Ressources est obligatoire dans chaque CloudFormation modèle et constitue le cœur du modèle. Cette section décrit les ressources de la pile et leurs propriétés, telles qu'une EC2 instance Amazon 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 résultats fournissent des informations utiles, telles que des identifiants de ressources URLs, qui peuvent être utilisées à des fins opérationnelles ou pour être intégrées à 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 pour les scénarios dans lesquels vous devez ajuster les configurations en fonction de conditions telles que Région AWS 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), il indique la version du modèle d'AWS application sans serveur AWS (SAM) à utiliser. Lorsque vous spécifiez une transformation, vous pouvez utiliser AWS SAM la syntaxe pour déclarer les 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 AWS::Include transformation pour inclure des extraits de modèle stockés séparément du modèle principal CloudFormation .

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