View a markdown version of this page

Infrastructure de composants sous forme de fichiers de code - AWS Proton
Utilisation de paramètres avec des composantsCréation de fichiers IaC robustes

Avis de fin de support : le 7 octobre 2026, AWS le support pour AWS Proton. Après le 7 octobre 2026, vous ne pourrez plus accéder à la AWS Proton console ni aux AWS Proton ressources. Votre infrastructure déployée restera intacte. Pour plus d'informations, consultez le Guide AWS Proton de dépréciation et de migration des services.

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.

Infrastructure de composants sous forme de fichiers de code

Les fichiers d'infrastructure des composants sous forme de code (IaC) sont similaires à ceux AWS Proton des autres ressources. Découvrez ici certains détails spécifiques aux composants. Pour des informations complètes sur la création de fichiers IaC pour AWS Proton, consultezCréation de modèles et création de packs pour AWS Proton.

Utilisation de paramètres avec des composants

L'espace de noms des AWS Proton paramètres inclut certains paramètres auxquels un fichier IaC de service peut faire référence pour obtenir le nom et les sorties d'un composant associé. L'espace de noms inclut également des paramètres auxquels un fichier IaC de composant peut faire référence pour obtenir des entrées, des sorties et des valeurs de ressources à partir de l'environnement, du service et de l'instance de service auxquels le composant est associé.

Un composant ne possède pas d'entrées propres ; il obtient ses entrées de l'instance de service à laquelle il est attaché. Un composant peut également lire les sorties de l'environnement.

Pour plus d'informations sur l'utilisation des paramètres dans les fichiers IaC des composants et des services associés, consultezDétails et exemples des paramètres du fichier CloudFormation iAC du composant. Pour obtenir des informations générales sur AWS Proton les paramètres et une référence complète de l'espace de noms des paramètres, consultezAWS Proton paramètres.

Création de fichiers IaC robustes

En tant qu'administrateur, lorsque vous créez une version de modèle de service, vous pouvez décider si vous souhaitez autoriser les instances de service créées à partir de la version du modèle à être associées à des composants. Consultez le ComponentSources paramètre pris en charge pour l'action d'CreateServiceTemplateVersionAPI dans la référence de l'AWS Proton API. Cependant, pour toute instance de service future, la personne qui crée l'instance, décide d'y attacher ou non un composant et (dans le cas de composants définis directement) crée le composant IaC est généralement une personne différente : un développeur utilisant votre modèle de service. Par conséquent, vous ne pouvez pas garantir qu'un composant soit attaché à une instance de service. Vous ne pouvez pas non plus garantir l'existence de noms de sortie de composants spécifiques ni la validité et la sécurité des valeurs de ces sorties.

AWS Proton et la syntaxe Jinja vous aident à contourner ces problèmes et à créer des modèles de service robustes qui s'affichent sans faille de la manière suivante :

  • AWS Proton filtres de paramètres  : lorsque vous faites référence aux propriétés de sortie des composants, vous pouvez utiliser des filtres de paramètres, des modificateurs qui valident, filtrent et mettent en forme les valeurs des paramètres. Pour plus d’informations et d’exemples, consultez Filtres de paramètres pour les fichiers CloudFormation IaC.

  • Propriété par défaut unique  : lorsque vous faites référence à une ressource ou à une propriété de sortie unique d'un composant, vous pouvez garantir que le rendu de votre modèle de service n'échouera pas en utilisant le default filtre, avec ou sans valeur par défaut. Si le composant, ou un paramètre de sortie spécifique auquel vous faites référence, n'existe pas, la valeur par défaut (ou une chaîne vide, si vous n'avez pas spécifié de valeur par défaut) est affichée à la place et le rendu réussit. Pour de plus amples informations, veuillez consulter Fournir des valeurs par défaut pour les références inexistantes.

    Exemples :

    • {{ service_instance.components.default.name | default("") }}

    • {{ service_instance.components.default.outputs.my-output | default("17") }}

    Note

    Ne confondez pas la .default partie de l'espace de noms, qui désigne les composants directement définis, avec le default filtre, qui fournit une valeur par défaut lorsque la propriété référencée n'existe pas.

  • Référence d'objet entier  : lorsque vous faites référence à l'ensemble du composant ou à l'ensemble des sorties d'un composant, AWS Proton renvoie un objet vide et garantit donc que le rendu de votre modèle de service n'échouera pas. {} Vous n'êtes pas obligé d'utiliser de filtre. Assurez-vous de faire la référence dans un contexte qui peut accepter un objet vide, ou utilisez une {{ if .. }} condition pour tester la présence d'un objet vide.

    Exemples :

    • {{ service_instance.components.default }}

    • {{ service_instance.components.default.outputs }}