Commencer à utiliser les flux de travail - Amazon CodeCatalyst

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

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é ? VoirCréation d'un projet à l'aide d'un plan, qui inclut des instructions pour configurer un projet avec un flux de travail fonctionnel, un exemple d'application et d'autres ressources.

Prérequis

Avant de commencer :

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

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.

  2. Choisissez Créer un flux de travail.

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

Pour configurer votre flux de travail

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

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

  2. Dans l'action Créer, choisissez + pour ajouter les actions YAML à 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_f0action, 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.

  3. 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 YAML propriétés affichées dans l'YAMLéditeur.

Étape 2 : Enregistrez votre flux de travail avec un commit

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 par le biais de validations.

Pour valider les modifications apportées à votre flux de travail
  1. (Facultatif) Choisissez Valider pour vous assurer que le YAML code du flux de travail est valide.

  2. Choisissez Commit (Valider).

  3. Dans Nom du fichier de flux de travail, entrez un nom pour le fichier de configuration de votre flux de travail, par exemplemy-first-workflow.

  4. Dans Message de validation, entrez un message pour identifier votre validation, par exemplecreate my-first-workflow.yaml.

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

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

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

Au cours de cette étape, vous accédez à l'exécution qui a été lancée à partir de 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_f0).

  2. Dans le diagramme d'exécution du flux de travail, choisissez l'action de génération (par exemple, Build_f0).

  3. 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 plus d’informations, consultez Afficher les résultats d'une action de construction.

(Facultatif) Étape 4 : Nettoyer

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. La suppression du projet entraîne également la suppression du référentiel source et du flux de travail.