Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md). 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. # Utilisation de variables prédéfinies Les *variables prédéfinies* sont des paires clé-valeur émises automatiquement par un flux de travail et mises à votre disposition pour que vous puissiez les utiliser dans des actions de flux de travail. Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). **Topics** + [Exemples de référencement de variables prédéfinies](workflows-predefined-examples.md) + [Référencement d'une variable prédéfinie](workflows-working-with-variables-reference-output-vars.md) + [Déterminer les variables prédéfinies émises par votre flux de travail](workflows-working-with-variables-determine-output-vars.md) + [Liste des variables prédéfinies](workflow-ref-action-variables.md) # Exemples de référencement de variables prédéfinies Les exemples suivants montrent comment référencer des variables prédéfinies dans le fichier de définition du flux de travail. Pour plus d'informations sur les variables prédéfinies, consultez[Utilisation de variables prédéfinies](workflows-using-predefined-variables.md). **Topics** + [Exemple : Référencement de la variable prédéfinie CommitId « »](#workflows-working-with-variables-ex-refer-action) + [Exemple : Référencement de la variable prédéfinie BranchName « »](#workflows-working-with-variables-ex-branch) ## Exemple : Référencement de la variable prédéfinie CommitId « » L'exemple suivant montre comment faire référence à la variable `CommitId` prédéfinie dans l'`MyBuildAction`action. La `CommitId` variable est sortie automatiquement par CodeCatalyst. Pour de plus amples informations, veuillez consulter [Liste des variables prédéfinies](workflow-ref-action-variables.md). Bien que l'exemple montre la variable utilisée dans l'action de génération, vous pouvez l'utiliser `CommitId` dans n'importe quelle action. ``` MyBuildAction: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource Configuration: Steps: #Build Docker image and tag it with a commit ID - Run: docker build -t image-repo/my-docker-image:latest . - Run: docker tag image-repo/my-docker-image:${WorkflowSource.CommitId} ``` ## Exemple : Référencement de la variable prédéfinie BranchName « » L'exemple suivant montre comment faire référence à la variable `BranchName` prédéfinie dans l'`CDKDeploy`action. La `BranchName` variable est sortie automatiquement par CodeCatalyst. Pour de plus amples informations, veuillez consulter [Liste des variables prédéfinies](workflow-ref-action-variables.md). Bien que l'exemple montre la variable utilisée dans l'action de **AWS CDK déploiement**, vous pouvez l'utiliser `BranchName` dans n'importe quelle action. ``` CDKDeploy: Identifier: aws/cdk-deploy@v2 Inputs: Sources: - WorkflowSource Configuration: StackName: app-stack-${WorkflowSource.BranchName} ``` # Référencement d'une variable prédéfinie Vous pouvez faire référence à des variables prédéfinies dans n'importe quelle action au sein d'un CodeCatalyst flux de travail Amazon. Utilisez les instructions suivantes pour référencer une variable prédéfinie dans un flux de travail. Pour plus d'informations sur les variables prédéfinies, consultez[Utilisation de variables prédéfinies](workflows-using-predefined-variables.md). **Prérequis** Déterminez le nom de la variable prédéfinie à laquelle vous souhaitez faire référence, par exemple`CommitId`. Pour de plus amples informations, veuillez consulter [Déterminer les variables prédéfinies émises par votre flux de travail](workflows-working-with-variables-determine-output-vars.md). ------ #### [ Visual ] *Non disponible Choisissez YAML pour afficher les instructions YAML.* ------ #### [ YAML ] **Pour référencer une variable prédéfinie (éditeur YAML)** 1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Choisissez votre projet. 1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.** 1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail. 1. Choisissez **Modifier**. 1. Choisissez **YAML.** 1. Dans une CodeCatalyst action, ajoutez la référence de variable prédéfinie en utilisant la syntaxe suivante : ``` ${action-group-name.action-name-or-WorkflowSource.variable-name} ``` Remplacez : + *action-group-name*avec le nom du groupe d'action. **Note** Vous pouvez omettre *action-group-name* s'il n'existe aucun groupe d'actions ou si la variable est produite par une action du même groupe d'actions. + *action-name-or-WorkflowSource*avec : Nom de l'action qui génère la variable. or `WorkflowSource`, si la variable est la `CommitId` variable `BranchName` ou. + *variable-name*avec le nom de la variable. Par exemple : ``` MySecondAction: Configuration: Steps: - Run: echo ${MyFirstECSAction.cluster} ``` Voici un autre exemple  : ``` MySecondAction: Configuration: Steps: - Run: echo ${WorkflowSource.CommitId} ``` Pour obtenir plus d’exemples, consultez [Exemples de référencement de variables prédéfinies](workflows-predefined-examples.md). Pour plus d'informations, consultez le [Définition du flux de travail YAML](workflow-reference.md) correspondant à votre action. 1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider. 1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**. ------ # Déterminer les variables prédéfinies émises par votre flux de travail Utilisez la procédure suivante pour déterminer les variables prédéfinies émises par un flux de travail lors de son exécution. Vous pouvez ensuite référencer ces variables dans le même flux de travail. Pour plus d'informations sur les variables prédéfinies, consultez[Utilisation de variables prédéfinies](workflows-using-predefined-variables.md). **Pour déterminer les variables prédéfinies émises par votre flux de travail** + Effectuez l’une des actions suivantes : + **Exécutez le flux de travail une seule fois**. Une fois l'exécution terminée, les variables émises par le flux de travail sont affichées dans l'onglet **Variables** de la page des détails de l'exécution. Pour de plus amples informations, veuillez consulter [Afficher le statut et les détails de l'exécution du flux de travail](workflows-view-run.md). + **Consultez le [Liste des variables prédéfinies](workflow-ref-action-variables.md)**. Cette référence répertorie le nom (clé) et la valeur de chaque variable prédéfinie. **Note** La taille totale maximale des variables d'un flux de travail est répertoriée dans[Quotas pour les flux de travail dans CodeCatalyst](workflows-quotas.md). Si la taille totale dépasse le maximum, l'action qui se produit une fois le maximum atteint peut échouer. # Liste des variables prédéfinies Consultez les sections suivantes pour visualiser les variables prédéfinies produites automatiquement par CodeCatalyst les actions dans le cadre d'un flux de travail. Pour plus d'informations sur les variables prédéfinies, consultez[Utilisation de variables prédéfinies](workflows-using-predefined-variables.md). **Note** Cette liste inclut uniquement les variables prédéfinies émises par la CodeCatalyst source et [CodeCatalyst les actions](workflows-actions.md#workflows-actions-types). Si vous utilisez d'autres types d'actions, telles que GitHub les actions Actions ou CodeCatalyst Labs, consultez plutôt[Déterminer les variables prédéfinies émises par votre flux de travail](workflows-working-with-variables-determine-output-vars.md). **List** **Note** Toutes les CodeCatalyst actions ne produisent pas de variables prédéfinies. Si l'action ne figure pas dans la liste, elle ne produit pas de variables. + [Variables BranchName « » et CommitId « »](workflows-sources-variables.md) + [Variables « Déployer la CloudFormation pile »](deploy-action-cfn-variables.md) + [Variables « Déployer sur Amazon ECS »](deploy-action-ecs-variables.md) + [Variables « Déployer vers un cluster Kubernetes »](deploy-action-eks-variables.md) + [variables « AWS CDK  déployer »](cdk-dep-action-variables.md) + [variables « AWS CDK  bootstrap »](cdk-boot-action-variables.md) + [variables « AWS Lambda  invoquer »](lam-invoke-action-variables.md) + [Variables « Afficher la définition de la tâche Amazon ECS »](render-ecs-action-variables.md)