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 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).