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 Paramètres, bien que facultative, joue un rôle important dans la flexibilité des modèles. Il permet aux utilisateurs de transmettre des valeurs lors 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 Outputs sections Resources et, ce qui permet de personnaliser le modèle 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 selon les déploiements.

La section Outputs, également facultative, définit les valeurs 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 permet aux utilisateurs de récupérer et d'utiliser des informations importantes sur les ressources créées par le modèle.

Les autres sections facultatives incluent les mappages, qui fonctionnent comme des tables de recherche pour gérer les valeurs conditionnelles. Avec les mappages, vous définissez des paires clé-valeur et vous les utilisez avec la fonction Fn::FindInMap intrinsèque dans les Resources sections 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 Métadonnées et Règles, bien que moins fréquemment utilisées, fournissent des fonctionnalités supplémentaires. Metadatapeut inclure des informations supplémentaires sur le modèle, tout en Rules validant un paramètre ou une combinaison de paramètres lors de la création ou de la mise à jour de la pile, en s'assurant 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 une valeur est attribuée à des propriétés en fonction de conditions telles que le type d'environnement.

Enfin, la section Transform permet d'appliquer des macros lors du 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 des informations supplémentaires et des exemples d'utilisation de chaque section.