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 dans les flux de travail Une *variable* est une paire clé-valeur qui contient des informations auxquelles vous pouvez faire référence dans votre flux de travail Amazon CodeCatalyst . La partie valeur de la variable est remplacée par une valeur réelle lors de l'exécution du flux de travail. Il existe deux types de variables que vous pouvez utiliser dans un flux de travail : + **Variables définies par l'utilisateur** : il s'agit de paires clé-valeur que vous définissez. + **Variables prédéfinies** : il s'agit de paires clé-valeur émises automatiquement par un flux de travail. Il n'est pas nécessaire que vous les définissiez. Pour de plus amples informations sur les flux de travail, veuillez consulter [Créez, testez et déployez avec des flux de travailCréez, testez et déployez avec des flux de travail](workflow.md). **Note** CodeCatalyst prend également en charge [les paramètres de GitHub sortie](https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter), qui se comportent comme des variables et peuvent être référencés dans d'autres actions. Pour plus d’informations, consultez [Exportation des paramètres GitHub de sortie](integrations-github-action-export.md) et [Référencement des paramètres GitHub de sortie](integrations-github-action-referencing.md). **Topics** + [Utilisation de variables définies par l'utilisateur](workflows-using-variables.md) + [Utilisation de variables prédéfinies](workflows-using-predefined-variables.md) # Utilisation de variables définies par l'utilisateur Les *variables définies par l'utilisateur* sont des paires clé-valeur que vous définissez. Deux types de listes de préfixes existent : + **Variables en texte brut**, ou simplement **variables** : il s'agit de paires clé-valeur que vous définissez en texte clair dans le fichier de définition du flux de travail. + **Secrets** : il s'agit de paires clé-valeur que vous définissez sur une page **Secrets** distincte de la console Amazon CodeCatalyst . La *clé* (nom) est une étiquette publique et la *valeur* contient les informations que vous souhaitez garder privées. Vous spécifiez uniquement la clé dans le fichier de définition du flux de travail. Utilisez des secrets à la place des mots de passe et autres informations sensibles dans le fichier de définition du flux de travail. **Note** Par souci de concision, ce guide utilise le terme *variable pour désigner une variable* en *texte brut*. Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). **Topics** + [Exemples de variables](workflows-working-with-variables-ex.md) + [Définition d'une variable](workflows-working-with-variables-define-input.md) + [Définition d'un secret](workflows-working-with-variables-define-secret.md) + [Exporter une variable afin que d'autres actions puissent l'utiliser](workflows-working-with-variables-export-input.md) + [Référencer une variable dans l'action qui la définit](workflows-working-with-variables-reference-input.md) + [Référencer une variable produite par une autre action](workflows-working-with-variables-reference-action.md) + [Référencer un secret](workflows-working-with-variables-reference-secret.md) # Exemples de variables Les exemples suivants montrent comment définir et référencer des variables dans le fichier de définition du 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** + [Exemple : définition d'une variable à l'aide de la propriété Inputs](#workflows-working-with-variables-ex-define-inputs) + [Exemple : définition d'une variable à l'aide de la propriété Steps](#workflows-working-with-variables-ex-define-steps) + [Exemple : exportation d'une variable à l'aide de la propriété Outputs](#workflows-working-with-variables-ex-export-outputs) + [Exemple : Référencement d'une variable définie dans la même action](#workflows-working-with-variables-ex-refer-current) + [Exemple : Référencement d'une variable définie dans une autre action](#workflows-working-with-variables-ex-refer-other) + [Exemple : référence à un secret](#workflows-working-with-variables-ex-refer-secret) ## Exemple : définition d'une variable à l'aide de la propriété Inputs L'exemple suivant montre comment définir deux variables, `VAR1` et`VAR2`, dans une `Inputs` section. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: "My variable 1" - Name: VAR2 Value: "My variable 2" ``` ## Exemple : définition d'une variable à l'aide de la propriété Steps L'exemple suivant montre comment définir explicitement une `DATE` variable dans la `Steps` section. ``` Actions: Build: Identifier: aws/build@v1 Configuration: Steps: - Run: DATE=$(date +%m-%d-%y) ``` ## Exemple : exportation d'une variable à l'aide de la propriété Outputs L'exemple suivant vous montre comment définir deux variables`TIMESTAMP`, `REPOSITORY-URI` et comment les exporter à l'aide de la `Outputs` section. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: REPOSITORY-URI Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - REPOSITORY-URI - TIMESTAMP ``` ## Exemple : Référencement d'une variable définie dans la même action L'exemple suivant vous montre comment spécifier une `VAR1` variable dans`MyBuildAction`, puis la référencer dans la même action en utilisant`$VAR1`. ``` Actions: MyBuildAction: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: my-value Configuration: Steps: - Run: $VAR1 ``` ## Exemple : Référencement d'une variable définie dans une autre action L'exemple suivant montre comment spécifier une `TIMESTAMP` variable dans`BuildActionA`, l'exporter à l'aide de la `Outputs` propriété, puis la référencer dans `BuildActionB` using`${BuildActionA.TIMESTAMP}`. ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - TIMESTAMP BuildActionB: Identifier: aws/build@v1 Configuration: Steps: - Run: docker build -t my-ecr-repo/image-repo:latest . - Run: docker tag my-ecr-repo/image-repo:${BuildActionA.TIMESTAMP} # Specifying just '$TIMESTAMP' here will not work # because TIMESTAMP is not a variable # in the BuildActionB action. ``` ## Exemple : référence à un secret L'exemple suivant montre comment faire référence à un `my-password` secret. `my-password`C'est la clé du secret. La clé de ce secret et la valeur de mot de passe correspondante doivent être spécifiées sur la page **Secrets** de la CodeCatalyst console avant d'être utilisés dans le fichier de définition du flux de travail. Pour de plus amples informations, veuillez consulter [Masquage de données à l'aide de secrets](workflows-secrets.md). ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: curl -u LiJuan:${Secrets.my-password} https://example.com ``` # Définition d'une variable Vous pouvez définir des variables de deux manières : + Dans la `Inputs` section d'une action de flux de travail, voir [Pour définir une variable dans la section « Entrées »](#workflows-to-define-variable-input) + Dans la `Steps` section d'une action de flux de travail, voir [Pour définir une variable dans la section « Étapes »](#workflows-to-define-variable-steps) **Note** La `Steps` méthode ne fonctionne qu'avec les actions de CodeCatalyst construction, de test et d'**GitHub actions**, car ce sont les seules actions qui incluent une `Steps` section. Pour obtenir des exemples, consultez [Exemples de variables](workflows-working-with-variables-ex.md). Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). ------ #### [ Visual ] **Pour définir une variable dans la section « Entrées » (éditeur visuel)** 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 **Visual**. 1. Dans le diagramme du flux de travail, choisissez l'action pour laquelle vous souhaitez définir la variable. 1. Choisissez **Entrées**. 1. Dans **Variables - facultatif**, choisissez **Ajouter une variable**, puis procédez comme suit : Spécifiez une séquence de name/value paires qui définit les variables d'entrée que vous souhaitez mettre à la disposition de l'action. Les noms de variables sont limités aux caractères alphanumériques (a-z, A-Z, 0-9), aux tirets (-) et aux traits de soulignement (\$1). Les espaces ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les caractères spéciaux et les espaces dans les noms de variables. Pour plus d'informations sur les variables, y compris des exemples, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). 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**. ------ #### [ YAML ] **Pour définir une variable dans la section « Entrées » (é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 action de flux de travail, ajoutez un code similaire au suivant : ``` action-name: Inputs: Variables: - Name: variable-name Value: variable-value ``` Pour obtenir plus d’exemples, consultez [Exemples de variables](workflows-working-with-variables-ex.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**. ------ ------ #### [ Visual ] **Pour définir une variable dans la section « Étapes » (éditeur visuel)** 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 **Visual**. 1. Dans le diagramme du flux de travail, choisissez l'action pour laquelle vous souhaitez définir la variable. 1. Choisissez **Configuration**. 1. Dans **les commandes Shell** ou **GitHubActions YAML**, selon les options disponibles, définissez une variable dans les actions`Steps`, de manière explicite ou implicite. + Pour définir la variable de manière explicite, incluez-la dans une commande bash directement dans la `Steps` section. + Pour définir implicitement une variable, spécifiez-la dans un fichier référencé dans la `Steps` section de l'action. Pour obtenir des exemples, consultez [Exemples de variables](workflows-working-with-variables-ex.md). Pour plus d'informations, reportez-vous à la section [Définition du flux de travail YAML](workflow-reference.md) dédiée à l'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**. ------ #### [ YAML ] **Pour définir une variable dans la section « Étapes » (é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 action de flux de travail, définissez une variable dans la `Steps` section de l'action, de manière explicite ou implicite. + Pour définir la variable de manière explicite, incluez-la dans une commande bash directement dans la `Steps` section. + Pour définir implicitement une variable, spécifiez-la dans un fichier référencé dans la `Steps` section de l'action. Pour obtenir des exemples, consultez [Exemples de variables](workflows-working-with-variables-ex.md). Pour plus d'informations, reportez-vous à la section [Définition du flux de travail YAML](workflow-reference.md) dédiée à l'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éfinition d'un secret Vous définissez un secret sur la page **Secrets** de la CodeCatalyst console. Pour de plus amples informations, veuillez consulter [Masquage de données à l'aide de secrets](workflows-secrets.md). Par exemple, vous pouvez définir un secret qui ressemble à ceci : + Nom (clé) : **my-password** + Valeur : **^\$1H3\$1\$1b9** Une fois le secret défini, vous pouvez spécifier la clé du secret (**my-password**) dans le fichier de définition du flux de travail. Pour obtenir un exemple montrant la façon de procéder, consultez [Exemple : référence à un secret](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret). # Exporter une variable afin que d'autres actions puissent l'utiliser Suivez les instructions ci-dessous pour exporter une variable depuis une action afin de pouvoir la référencer dans d'autres actions. Avant d'exporter une variable, notez les points suivants : + Si vous devez uniquement référencer la variable dans l'action où elle est définie, vous n'avez pas besoin de l'exporter. + Toutes les actions ne prennent pas en charge l'exportation de variables. Pour déterminer si votre action prend en charge cette fonctionnalité, parcourez les instructions de l'éditeur visuel qui suivent et vérifiez si l'action inclut un bouton **Variables** dans l'onglet **Sorties**. Dans l'affirmative, l'exportation de variables est prise en charge. + Pour exporter une variable depuis une GitHub action, consultez[Exportation des paramètres GitHub de sortie](integrations-github-action-export.md). Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). **Prérequis** Assurez-vous d'avoir défini la variable que vous souhaitez exporter. Pour de plus amples informations, veuillez consulter [Définition d'une variable](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] **Pour exporter une variable (éditeur visuel)** 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 **Visual**. 1. Dans le diagramme du flux de travail, choisissez l'action à partir de laquelle vous souhaitez exporter la variable. 1. Choisissez **Sorties**. 1. Dans **Variables - facultatif**, choisissez **Ajouter une variable**, puis procédez comme suit : Spécifiez le nom de la variable que vous souhaitez que l'action exporte. Cette variable doit déjà être définie dans la `Steps` section `Inputs` ou de la même 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**. ------ #### [ YAML ] **Pour exporter une variable (é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 l'action à partir de laquelle vous souhaitez exporter la variable, ajoutez un code similaire au suivant : ``` action-name: Outputs: Variables: - Name: variable-name ``` Pour obtenir plus d’exemples, consultez [Exemples de variables](workflows-working-with-variables-ex.md). 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**. ------ # Référencer une variable dans l'action qui la définit Suivez les instructions ci-dessous pour référencer une variable dans l'action qui la définit. **Note** Pour référencer une variable générée par une GitHub action, consultez[Référencement des paramètres GitHub de sortie](integrations-github-action-referencing.md). Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). **Prérequis** Assurez-vous d'avoir défini la variable à laquelle vous souhaitez faire référence. Pour de plus amples informations, veuillez consulter [Définition d'une variable](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] *Non disponible Choisissez YAML pour afficher les instructions YAML.* ------ #### [ YAML ] **Pour référencer une variable dans l'action qui la définit** 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 l' CodeCatalyst action qui définit la variable à laquelle vous souhaitez faire référence, ajoutez-la en utilisant la syntaxe bash suivante : ``` $variable-name ``` Par exemple : ``` MyAction: Configuration: Steps: - Run: $variable-name ``` Pour obtenir plus d’exemples, consultez [Exemples de variables](workflows-working-with-variables-ex.md). Pour plus d'informations, consultez les informations de référence relatives à votre action dans le[Définition du flux de travail YAML](workflow-reference.md). 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**. ------ # Référencer une variable produite par une autre action Utilisez les instructions suivantes pour référencer les variables produites par d'autres actions. **Note** Pour référencer une variable issue d'une GitHub action, consultez[Référencement des paramètres GitHub de sortie](integrations-github-action-referencing.md). Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). **Prérequis** Assurez-vous d'avoir exporté la variable à laquelle vous souhaitez faire référence. Pour de plus amples informations, veuillez consulter [Exporter une variable afin que d'autres actions puissent l'utiliser](workflows-working-with-variables-export-input.md). ------ #### [ Visual ] *Non disponible. Choisissez YAML pour afficher les instructions YAML.* ------ #### [ YAML ] **Pour référencer une variable produite par une autre action (é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 l' CodeCatalyst action, ajoutez une référence à la variable en utilisant la syntaxe suivante : ``` ${action-group-name.action-name.variable-name} ``` Remplacez : + *action-group-name*avec le nom du groupe d'actions qui contient l'action qui produit une variable. **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*avec le nom de l'action qui génère la variable. + *variable-name*avec le nom de la variable. Par exemple : ``` MySecondAction: Configuration: Steps: - Run: ${MyFirstAction.TIMESTAMP} ``` Pour obtenir plus d’exemples, consultez [Exemples de variables](workflows-working-with-variables-ex.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**. ------ # Référencer un secret Pour obtenir des instructions sur le référencement d'un secret dans le fichier de définition du flux de travail, consultez[Utilisation d’un secret](workflows-secrets.using.md). Pour obtenir un exemple, consultez [Exemple : référence à un secret](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret). # 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)