Détails et exemples des paramètres du fichier CloudFormation IaC du service - AWS Proton

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.

Détails et exemples des paramètres du fichier CloudFormation IaC du service

Vous pouvez définir et référencer les paramètres de votre infrastructure de service et de pipeline sous forme de fichiers de code (iAc). Pour une description détaillée des AWS Proton paramètres, des types de paramètres, de l'espace de noms des paramètres et de la façon d'utiliser les paramètres dans vos fichiers iAc, consultezAWS Proton paramètres.

Définir les paramètres du service

Vous pouvez définir des paramètres d'entrée et de sortie pour les fichiers IaC du service.

  • Paramètres d'entrée : définissez les paramètres d'entrée de l'instance de service dans votre fichier de schéma.

    La liste suivante inclut des exemples de paramètres d'entrée de service pour des cas d'utilisation typiques.

    • Port

    • Taille de la tâche

    • Image

    • Nombre souhaité

    • fichier Docker

    • Commande de test unitaire

    Vous fournissez des valeurs pour les paramètres d'entrée lorsque vous créez un service :

    • Utilisez la console pour remplir un formulaire basé sur un schéma qui AWS Proton fournit.

    • Utilisez la CLI pour fournir une spécification qui inclut les valeurs.

  • Paramètres de sortie — Définissez les sorties des instances de service dans vos fichiers IaC de service. Vous pouvez ensuite faire référence à ces sorties dans les fichiers IaC d'autres ressources.

Lire les valeurs des paramètres dans les fichiers IaC du service

Vous pouvez lire les paramètres relatifs au service et à d'autres ressources dans les fichiers IaC du service. Vous pouvez lire la valeur d'un paramètre en faisant référence au nom du paramètre dans l'espace de noms des AWS Proton paramètres.

  • Paramètres d'entrée — Lisez la valeur d'entrée d'une instance de service en la référençantservice_instance.inputs.input-name.

  • Paramètres des ressources : lisez les paramètres AWS Proton des ressources en faisant référence à des noms tels que service.nameservice_instance.name, etenvironment.name.

  • Paramètres de sortie — Lisez les sorties d'autres ressources en faisant référence à environment.outputs.output-name ouservice_instance.components.default.outputs.output-name.

Exemple de fichier IaC de service avec paramètres

L'exemple suivant est un extrait d'un fichier IaC de service CloudFormation . L'espace de environment.outputs. noms fait référence aux sorties du fichier IaC de l'environnement. L'espace de service_instance.inputs. noms fait référence aux paramètres d'entrée de l'instance de service. La service_instance.name propriété fait référence à un paramètre de AWS Proton ressource.

Resources: StoreServiceInstanceInputValue: Type: AWS::SSM::Parameter Properties: Type: String Value: "{{ service.name }} {{ service_instance.name }} {{ service_instance.inputs.my_sample_service_instance_required_input }} {{ service_instance.inputs.my_sample_service_instance_optional_input }} {{ environment.outputs.MySampleInputValue }} {{ environment.outputs.MyOtherSampleInputValue }}" # resource parameter references # input parameter references # output references to an environment infrastructure as code file Outputs: MyServiceInstanceParameter: # output definition Value: !Ref StoreServiceInstanceInputValue MyServiceInstanceRequiredInputValue: # output definition Value: "{{ service_instance.inputs.my_sample_service_instance_required_input }}" # input parameter reference MyServiceInstanceOptionalInputValue: # output definition Value: "{{ service_instance.inputs.my_sample_service_instance_optional_input }}" # input parameter reference MyServiceInstancesEnvironmentSampleOutputValue: # output definition Value: "{{ environment.outputs.MySampleInputValue }}" # output reference to an environment IaC file MyServiceInstancesEnvironmentOtherSampleOutputValue: # output definition Value: "{{ environment.outputs.MyOtherSampleInputValue }}" # output reference to an environment IaC file