

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.

# Connecter les référentiels sources aux flux de travail
<a name="workflows-sources"></a>

Une *source*, également appelée *source d'entrée*, est un référentiel de sources auquel une [action de flux](workflows-actions.md) de travail se connecte afin d'obtenir les fichiers dont elle a besoin pour effectuer ses opérations. Par exemple, une action de flux de travail peut se connecter à un référentiel source pour obtenir les fichiers source d'une application afin de créer une application.

CodeCatalyst les flux de travail prennent en charge les sources suivantes :
+ CodeCatalyst référentiels de sources — Pour plus d'informations, consultez[Stockez du code et collaborez sur celui-ci avec des référentiels de sources dans CodeCatalystStockez du code et collaborez sur celui-ci avec des référentiels de sources](source.md).
+ GitHub référentiels, référentiels Bitbucket et référentiels de GitLab projets — Pour plus d'informations, consultez. [Ajoutez des fonctionnalités aux projets avec des extensions dans CodeCatalystAjoutez des fonctionnalités aux projets avec des extensions](extensions.md)

**Topics**
+ [Spécification du référentiel source d'un fichier de flux de travail](workflows-sources-specify-workflow-def.md)
+ [Spécifier le référentiel source d'une action de flux de travail](workflows-sources-specify-action.md)
+ [Référencement des fichiers du référentiel source](workflows-sources-reference-files.md)
+ [Variables BranchName « » et CommitId « »](workflows-sources-variables.md)

# Spécification du référentiel source d'un fichier de flux de travail
<a name="workflows-sources-specify-workflow-def"></a>

Suivez les instructions ci-dessous pour spécifier le référentiel CodeCatalyst source dans lequel vous souhaitez stocker le fichier de définition du flux de travail. Si vous préférez spécifier un GitHub dépôt, un dépôt Bitbucket ou un dépôt de GitLab projet, consultez plutôt[Ajoutez des fonctionnalités aux projets avec des extensions dans CodeCatalystAjoutez des fonctionnalités aux projets avec des extensions](extensions.md).

Le référentiel source dans lequel se trouve votre fichier de définition de flux de travail est identifié par l'étiquette,`WorkflowSource`.

**Note**  
Vous spécifiez le référentiel source dans lequel se trouve votre fichier de définition de flux de travail lorsque vous validez votre fichier de définition de flux de travail pour la première fois. Après cette validation, le référentiel et le fichier de définition du flux de travail sont liés ensemble de manière permanente. La seule façon de modifier le référentiel après la validation initiale est de recréer le flux de travail dans un autre référentiel.

**Pour spécifier le référentiel source qui stockera le fichier de définition du flux de travail**

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 **Créer un flux de travail** et créez le flux de travail. Pour de plus amples informations, veuillez consulter [Création d'un flux de travail](workflows-create-workflow.md).

   Au cours du processus de création du flux de travail, vous pouvez spécifier le CodeCatalyst référentiel, la branche et le dossier dans lesquels vous souhaitez stocker le fichier de définition du flux de travail.

# Spécifier le référentiel source d'une action de flux de travail
<a name="workflows-sources-specify-action"></a>

Suivez les instructions ci-dessous pour spécifier le référentiel source à utiliser avec une action de flux de travail. Au démarrage, l'action regroupe les fichiers du référentiel source configuré dans un artefact, télécharge l'artefact sur l'[image Docker de l'environnement d'exécution](build-images.md) dans lequel l'action est exécutée, puis termine son traitement à l'aide des fichiers téléchargés.

**Note**  
Actuellement, dans le cadre d'une action de flux de travail, vous ne pouvez spécifier qu'un seul référentiel source, à savoir le référentiel source dans lequel réside le fichier de définition du flux de travail (dans le `.codecatalyst/workflows/` répertoire ou l'un de ses sous-répertoires). Ce référentiel source est représenté par l'étiquette`WorkflowSource`.

------
#### [ Visual ]

**Pour spécifier le référentiel source qu'une action utilisera (é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 spécifier la source.

1. Choisissez **Entrées**.

1. Dans **Sources (facultatif)**, procédez comme suit :

   Spécifiez les étiquettes qui représentent les référentiels sources qui seront nécessaires à l'action. Actuellement, la seule étiquette prise en charge est`WorkflowSource`, qui représente le référentiel source dans lequel votre fichier de définition de flux de travail est stocké.

   Si vous omettez une source, vous devez spécifier au moins un artefact d'entrée sous. `action-name/Inputs/Artifacts`

   Pour plus d'informations sur les sources, consultez [Connecter les référentiels sources aux flux de travail](workflows-sources.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 spécifier le référentiel source qu'une action utilisera (é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, ajoutez un code similaire au suivant :

   ```
   action-name:
    Inputs:
      Sources:
        - WorkflowSource
   ```

   Pour plus d'informations, consultez la description de la `Sources` propriété dans [Définition du flux de travail YAML](workflow-reference.md) Pour 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érencement des fichiers du référentiel source
<a name="workflows-sources-reference-files"></a>

Si des fichiers se trouvent dans un référentiel source et que vous devez y faire référence dans l'une des actions de votre flux de travail, procédez comme suit.

**Note**  
Consultez également [Référencement de fichiers dans un artefact](workflows-working-artifacts-refer-files.md).

**Pour référencer un fichier stocké dans un référentiel source**
+ Dans l'action dans laquelle vous souhaitez référencer un fichier, ajoutez un code similaire au suivant :

  ```
  Actions:
    My-action:
      Inputs:
        Sources:
          - WorkflowSource
        Configuration:
          Steps:
          - run: cd my-app && cat file1.jar
  ```

  Dans le code précédent, l'action recherche dans le `my-app` répertoire situé à la racine du référentiel `WorkflowSource` source pour rechercher et afficher le `file1.jar` fichier.

# Variables BranchName « » et CommitId « »
<a name="workflows-sources-variables"></a>

La CodeCatalyst source produit `BranchName` et définit des `CommitId` variables lors de l'exécution de votre flux de travail. Ces variables sont connues sous le nom de *variables prédéfinies*. Consultez le tableau suivant pour plus d'informations sur ces variables.

Pour plus d'informations sur le référencement de ces variables dans un flux de travail, consultez[Utilisation de variables prédéfinies](workflows-using-predefined-variables.md).


| Clé | Valeur | 
| --- | --- | 
|  CommitId  |  L'ID de validation représentant l'état du référentiel au moment du début de l'exécution du flux de travail. Exemple : `example3819261db00a3ab59468c8b` Voir aussi : [Exemple : Référencement de la variable prédéfinie CommitId « »](workflows-predefined-examples.md#workflows-working-with-variables-ex-refer-action)  | 
|  BranchName  |  Nom de la branche sur laquelle l'exécution du flux de travail a débuté. Exemples : `main`, `feature/branch`, `test-LiJuan` Voir aussi : [Exemple : Référencement de la variable prédéfinie BranchName « »](workflows-predefined-examples.md#workflows-working-with-variables-ex-branch)  | 