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.
Exporter des informations à partir d'une pile déployée
Lorsque vous avez plusieurs piles dans la même Compte AWS région, vous souhaiterez peut-être partager des informations entre elles. Cela est utile lorsqu'une pile doit utiliser des ressources créées par une autre pile.
Par exemple, vous pouvez avoir une pile qui crée des ressources réseau, telles que des sous-réseaux et des groupes de sécurité, pour vos serveurs Web. Les autres piles qui créent les serveurs Web réels peuvent ensuite utiliser les ressources réseau créées par la première pile. Vous n'avez pas besoin de coder en dur la ressource IDs dans le modèle de la pile ou de la transmettre IDs en tant que paramètres d'entrée.
Pour partager des informations entre piles, vous exportez les valeurs de sortie d'une pile et vous les importez dans une autre pile. Voici comment cela fonctionne :
-
Dans le modèle de la première pile (par exemple, la pile réseau), vous définissez certaines valeurs à exporter en utilisant le
Export
champ de la section Sortie. -
Lorsque vous créez ou mettez à jour cette pile, CloudFormation exportez les valeurs de sortie pour les mettre à la disposition d'autres piles de la même pile Compte AWS et de la même région.
-
Dans le modèle de l'autre pile, vous utilisez la Fn::ImportValuefonction pour importer les valeurs exportées depuis la première pile.
-
Lorsque vous créez ou mettez à jour la deuxième pile (par exemple, la pile de serveurs Web), récupère CloudFormation automatiquement les valeurs exportées de la première pile et les utilise.
Pour obtenir une procédure pas à pas et des exemple de modèles, consultez Référez-vous aux sorties de ressources dans une autre CloudFormation pile.
Note
Lorsqu'une autre pile importe une valeur de sortie, vous ne peut pas supprimer la pile qui exporte la valeur de sortie ou modifier la valeur de sortie exportée. Toutes les importations doivent être supprimées avant de pouvoir supprimer la pile d'exportation ou modifier la valeur de sortie.
Exportation de valeurs de sortie de pile comparée à l'utilisation de piles imbriquées
Une pile imbriquée est une pile que vous créez dans une autre pile à l'aide de la ressource AWS::CloudFormation::Stack
. Avec les piles imbriquées, vous déployez et gérez toutes les ressources à partir d'une même pile. Vous pouvez utiliser les sorties d'une pile du groupe de piles imbriquées comme entrées dans une autre pile du groupe. Cela est différent de l'exportation de valeurs.
Si vous voulez isoler le partage d'informations au sein d'un groupe de piles imbriquées, nous vous conseillons d'utiliser des piles imbriquées. Pour partager des informations avec d'autres piles (et pas seulement dans le groupe de piles imbriquées), il convient d'exporter les valeurs. Par exemple, vous pouvez créer une pile unique avec un sous-réseau, puis exporter son ID. Les autres piles peuvent utiliser ce sous-réseau en important son ID ; il n'est pas nécessaire de créer un sous-réseau pour chaque pile. Tant que les piles importent l'ID du sous-réseau, vous ne pouvez pas le modifier ni le supprimer.
Pour plus d'informations sur les piles imbriquées, consultez. Intégrez des piles dans d'autres piles à l'aide de piles imbriquées
Affichage des valeurs de sortie exportées
Pour voir les valeurs que vous pouvez importer, listez toutes les valeurs de sortie exportées à l'aide de la CloudFormation console AWS CLI, ou CloudFormation API. CloudFormation affiche les noms et les valeurs des sorties exportées pour la région actuelle et la pile à partir de laquelle les sorties sont exportées. Pour référencer une valeur de sortie exportée dans le modèle d'une pile, utilisez le nom de l'exportation et la fonction Fn::ImportValue.
Pour afficher les valeurs de sortie exportées (console)
-
Dans le volet de CloudFormationnavigation de la CloudFormation console
, sélectionnez Exports.
Pour afficher les valeurs de sortie exportées (AWS CLI)
-
Exécutez la commande list-exports.
Pour afficher les valeurs de sortie exportées (API)
-
Lancez l'ListExportsAPIopération.
Affichage des piles qui importent une valeur de sortie exportée
Lorsque vous exportez une valeur de sortie, les piles appartenant au même AWS compte et à la même région peuvent importer cette valeur. Pour afficher les piles qui importent une valeur de sortie particulière, utilisez l'action Répertorier l'importation.
Pour supprimer ou modifier des valeurs de sortie exportées, utilisez l'action ListImports
pour effectuer le suivi des piles qui procèdent à l'importation, puis modifiez ces piles pour supprimer les fonctions Fn::ImportValue qui référencent les valeurs de sortie. Vous devez supprimer toutes les importations qui font référence aux valeurs de sortie exportées avant de pouvoir supprimer ou modifier les valeurs de sortie exportées.
Pour plus d'informations sur l'exportation et l'importation des valeurs de sortie, consultez Exporter des informations à partir d'une pile déployée.
Pour répertorier les piles qui importent une valeur de sortie exportée (console)
-
Dans le volet de CloudFormationnavigation de la CloudFormation console
, sélectionnez Exports. -
Pour voir quelles piles importent une valeur d'exportation donnée, choisissez le nom d'exportation pour cette valeur d'exportation. CloudFormation affiche la page des détails de l'exportation, qui répertorie toutes les piles qui importent la valeur.
Pour répertorier les piles qui importent une valeur de sortie exportée (AWS CLI)
-
Exécutez la commande list-imports en indiquant le nom de la valeur de sortie exportée.
CloudFormation renvoie une liste des piles qui importent la valeur.
Pour répertorier les piles qui importent une valeur de sortie exportée () API
-
Exécutez le ListImportsAPI, en fournissant le nom de la valeur de sortie exportée.
CloudFormation renvoie une liste des piles qui importent la valeur.