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.

# Commencer à utiliser les flux de travail
<a name="workflows-getting-started"></a>

Dans ce didacticiel, vous allez apprendre à créer et à configurer votre premier flux de travail.

**Astuce**  
Vous préférez commencer par un flux de travail préconfiguré ? Voir[Création d'un projet à l'aide d'un plan](projects-create.md#projects-create-console-template), qui inclut des instructions pour configurer un projet avec un flux de travail fonctionnel, un exemple d'application et d'autres ressources.

**Topics**
+ [Conditions préalables](#get-started-create-workflow-prerequisites)
+ [Étape 1 : créer et configurer votre flux de travail](#get-started-create-workflow-create)
+ [Étape 2 : Enregistrez votre flux de travail avec un commit](#get-started-create-workflow-commit)
+ [Étape 3 : Afficher les résultats de la course](#get-started-create-workflow-results)
+ [(Facultatif) Étape 4 : nettoyer](#get-started-create-workflow-cleanup)

## Conditions préalables
<a name="get-started-create-workflow-prerequisites"></a>

Avant de commencer :
+ Tu as besoin d'un CodeCatalyst **espace**. Pour de plus amples informations, veuillez consulter [Création d’un espace](spaces-create.md).
+ Dans votre CodeCatalyst espace, vous avez besoin d'un projet vide appelé :

  ```
  codecatalyst-project
  ```

   Pour de plus amples informations, veuillez consulter [Création d'un projet vide dans Amazon CodeCatalyst](projects-create.md#projects-create-empty).
+ Dans votre projet, vous avez besoin d'un CodeCatalyst **dépôt** appelé :

  ```
  codecatalyst-source-repository
  ```

  Pour de plus amples informations, veuillez consulter [Création d'un référentiel source](source-repositories-create.md).

**Note**  
Si vous avez un projet et un référentiel de sources existants, vous pouvez les utiliser ; toutefois, la création de nouveaux référentiels facilitera le nettoyage à la fin de ce didacticiel.

## Étape 1 : créer et configurer votre flux de travail
<a name="get-started-create-workflow-create"></a>

Au cours de cette étape, vous créez et configurez un flux de travail qui génère et teste automatiquement votre code source lorsque des modifications sont apportées.

**Pour créer votre flux de travail**

1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**

1. Choisissez **Créer un flux de travail**.

   Le fichier de définition du flux de travail apparaît dans l'éditeur YAML de la CodeCatalyst console.

**Pour configurer votre flux de travail**

Vous pouvez configurer votre flux de travail dans l'éditeur **visuel** ou dans l'éditeur **YAML.** Commençons par l'éditeur YAML, puis passons à l'éditeur visuel.

1. Choisissez **\$1 Actions** pour afficher la liste des actions de flux de travail que vous pouvez ajouter à votre flux de travail.

1. Dans l'action **Créer**, choisissez **\$1** pour ajouter le code YAML de l'action à votre fichier de définition de flux de travail. Votre flux de travail ressemble désormais à ce qui suit.

   ```
   Name: Workflow_fe47
   SchemaVersion: "1.0"
   
   # Optional - Set automatic triggers.
   Triggers:
     - Type: Push
       Branches:
         - main
   
   # Required - Define action configurations.
   Actions:
     Build_f0:
       Identifier: aws/build@v1
   
       Inputs:
         Sources:
           - WorkflowSource # This specifies that the action requires this workflow as a source
   
       Outputs:
         AutoDiscoverReports:
           Enabled: true
           # Use as prefix for the report files
           ReportNamePrefix: rpt
   
       Configuration:
         Steps:
           - Run: echo "Hello, World!"
           - Run: echo "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>" >> report.xml
           - Run: echo "<testsuite tests=\"1\" name=\"TestAgentJunit\" >" >> report.xml
           - Run: echo "<testcase classname=\"TestAgentJunit\" name=\"Dummy
               Test\"/></testsuite>" >> report.xml
   ```

   Le flux de travail copie les fichiers du référentiel `WorkflowSource` source sur la machine de calcul qui exécute l'`Build_f0`action, les imprime `Hello, World!` dans les journaux, découvre les rapports de test sur la machine de calcul et les affiche sur la page **Rapports** de la CodeCatalyst console.

1. Choisissez **Visual** pour afficher le fichier de définition du flux de travail dans l'éditeur visuel. Les champs de l'éditeur visuel vous permettent de configurer les propriétés YAML affichées dans l'éditeur YAML.

## Étape 2 : Enregistrez votre flux de travail avec un commit
<a name="get-started-create-workflow-commit"></a>

Au cours de cette étape, vous devez enregistrer vos modifications. Les flux de travail étant stockés sous forme de `.yaml` fichiers dans votre référentiel, vous enregistrez vos modifications sous forme de validations.

**Pour valider les modifications apportées à votre flux de travail**

1. (Facultatif) Choisissez **Valider** pour vous assurer que le code YAML du flux de travail est valide.

1. Choisissez **Commit (Valider)**.

1. Dans **Nom du fichier de flux** de travail, entrez un nom pour le fichier de configuration de votre flux de travail, par exemple**my-first-workflow**.

1. Dans **Message de validation**, entrez un message pour identifier votre validation, par exemple**create my-first-workflow.yaml**.

1. Dans **Référentiel**, choisissez le référentiel dans lequel vous souhaitez enregistrer le flux de travail (`codecatalyst-repository`).

1. Dans **Nom de la branche**, choisissez la branche dans laquelle vous souhaitez enregistrer le flux de travail (`main`).

1. Choisissez **Commit (Valider)**.

Votre nouveau flux de travail apparaît dans la liste des flux de travail. L'affichage peut prendre plusieurs minutes.

Étant donné que les flux de travail sont enregistrés avec des validations et qu'un déclencheur push de code est configuré pour le flux de travail, l'enregistrement du flux de travail démarre automatiquement l'exécution d'un flux de travail.

## Étape 3 : Afficher les résultats de la course
<a name="get-started-create-workflow-results"></a>

Au cours de cette étape, vous accédez à l'exécution qui a été lancée depuis votre validation et vous visualisez les résultats.

**Pour afficher les résultats d'une course**

1. Choisissez le nom de votre flux de travail, par exemple,`Workflow_fe47`.

   Un diagramme de flux de travail montrant l'étiquette de votre référentiel source (**WorkflowSource**) et l'action de génération (par exemple, **Build\$1f0**).

1. Dans le diagramme d'exécution du flux de travail, choisissez l'action de génération (par exemple, **Build\$1f0**).

1. Passez en revue le contenu des onglets **Journaux**, **Rapports**, **Configuration** et **Variables**. Ces onglets vous montrent les résultats de votre action de création.

   Pour de plus amples informations, veuillez consulter [Afficher les résultats d'une action de construction](build-view-results.md).

## (Facultatif) Étape 4 : nettoyer
<a name="get-started-create-workflow-cleanup"></a>

Au cours de cette étape, vous allez nettoyer les ressources que vous avez créées dans ce didacticiel.

**Pour supprimer des ressources**
+ Si vous avez créé un nouveau projet pour ce didacticiel, supprimez-le. Pour obtenir des instructions, veuillez consulter [Suppression d’un projet](projects-delete.md). La suppression du projet entraîne également la suppression du référentiel source et du flux de travail.