Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erste Schritte mit Workflows
<a name="workflows-getting-started"></a>

In diesem Tutorial erfahren Sie, wie Sie Ihren ersten Workflow erstellen und konfigurieren.

**Tipp**  
Möchten Sie lieber mit einem vorkonfigurierten Workflow beginnen? Siehe[Ein Projekt mit einem Blueprint erstellen](projects-create.md#projects-create-console-template), dort finden Sie Anweisungen zum Einrichten eines Projekts mit einem funktionierenden Workflow, eine Beispielanwendung und andere Ressourcen.

**Topics**
+ [Voraussetzungen](#get-started-create-workflow-prerequisites)
+ [Schritt 1: Erstellen und konfigurieren Sie Ihren Workflow](#get-started-create-workflow-create)
+ [Schritt 2: Speichern Sie Ihren Workflow mit einem Commit](#get-started-create-workflow-commit)
+ [Schritt 3: Ausführungsergebnisse anzeigen](#get-started-create-workflow-results)
+ [(Optional) Schritt 4: Bereinigen](#get-started-create-workflow-cleanup)

## Voraussetzungen
<a name="get-started-create-workflow-prerequisites"></a>

Bevor Sie beginnen:
+ Sie benötigen ein CodeCatalyst **Leerzeichen**. Weitere Informationen finden Sie unter [Erstellen einer Umgebung](spaces-create.md).
+ In Ihrem CodeCatalyst Bereich benötigen Sie ein leeres Projekt mit dem Namen:

  ```
  codecatalyst-project
  ```

   Weitere Informationen finden Sie unter [Ein leeres Projekt in Amazon erstellen CodeCatalyst](projects-create.md#projects-create-empty).
+ In Ihrem Projekt benötigen Sie ein CodeCatalyst **Repository** mit dem Namen:

  ```
  codecatalyst-source-repository
  ```

  Weitere Informationen finden Sie unter [Erstellen eines Quell-Repositorys](source-repositories-create.md).

**Anmerkung**  
Wenn Sie bereits über ein Projekt und ein Quell-Repository verfügen, können Sie diese verwenden. Wenn Sie jedoch neue erstellen, wird das Aufräumen am Ende dieses Tutorials erleichtert.

## Schritt 1: Erstellen und konfigurieren Sie Ihren Workflow
<a name="get-started-create-workflow-create"></a>

In diesem Schritt erstellen und konfigurieren Sie einen Workflow, der Ihren Quellcode automatisch erstellt und testet, wenn Änderungen vorgenommen werden.

**Um Ihren Workflow zu erstellen**

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**

1. Wählen Sie Workflow **erstellen** aus.

   Die Workflow-Definitionsdatei wird im YAML-Editor der CodeCatalyst Konsole angezeigt.

**Um Ihren Workflow zu konfigurieren**

Sie können Ihren Workflow im **Visual** Editor oder im **YAML-Editor** konfigurieren. Beginnen wir mit dem YAML-Editor und wechseln dann zum visuellen Editor.

1. Wählen Sie **\$1 Aktionen**, um eine Liste von Workflow-Aktionen anzuzeigen, die Sie Ihrem Workflow hinzufügen können.

1. Wählen Sie in der Aktion **Erstellen** **\$1** aus, um das YAML der Aktion zu Ihrer Workflow-Definitionsdatei hinzuzufügen. Ihr Workflow sieht jetzt wie folgt aus.

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

   **Der Workflow kopiert die Dateien im `WorkflowSource` Quell-Repository auf den Computer, auf dem die `Build_f0` Aktion ausgeführt wird, druckt `Hello, World!` in die Protokolle, erkennt Testberichte auf dem Computercomputer und gibt sie auf der Berichtsseite der CodeCatalyst Konsole aus.**

1. Wählen Sie **Visual**, um die Workflow-Definitionsdatei im Visual Editor anzuzeigen. Mit den Feldern im visuellen Editor können Sie die im YAML-Editor angezeigten YAML-Eigenschaften konfigurieren.

## Schritt 2: Speichern Sie Ihren Workflow mit einem Commit
<a name="get-started-create-workflow-commit"></a>

In diesem Schritt speichern Sie Ihre Änderungen. Da Workflows als `.yaml` Dateien in Ihrem Repository gespeichert werden, speichern Sie Ihre Änderungen mit Commits.

**Um Ihre Workflow-Änderungen zu übernehmen**

1. (Optional) Wählen Sie **Validieren**, um sicherzustellen, dass der YAML-Code des Workflows gültig ist.

1. Wählen Sie **Commit** (Übergeben).

1. Geben Sie im Feld **Workflow-Dateiname** einen Namen für Ihre Workflow-Konfigurationsdatei ein, z. B. **my-first-workflow**

1. Geben Sie im Feld **Commit-Nachricht** eine Nachricht ein, um Ihren Commit zu identifizieren, z. **create my-first-workflow.yaml** B.

1. Wählen Sie unter **Repository** das Repository aus, in dem Sie den Workflow speichern möchten (`codecatalyst-repository`).

1. Wählen Sie unter **Branchname** den Branch aus, in dem Sie den Workflow speichern möchten (`main`).

1. Wählen Sie **Commit** (Übergeben).

Ihr neuer Workflow wird in der Liste der Workflows angezeigt. Es kann einen Moment dauern, bis es angezeigt wird.

Da Workflows mit Commits gespeichert werden und für den Workflow ein Code-Push-Trigger konfiguriert ist, wird beim Speichern des Workflows automatisch eine Workflow-Ausführung gestartet.

## Schritt 3: Ausführungsergebnisse anzeigen
<a name="get-started-create-workflow-results"></a>

In diesem Schritt navigieren Sie zu dem Lauf, der von Ihrem Commit aus gestartet wurde, und sehen sich die Ergebnisse an.

**Um die Ergebnisse des Laufs anzuzeigen**

1. Wählen Sie den Namen Ihres Workflows, zum Beispiel`Workflow_fe47`.

   Ein Workflow-Diagramm, das die Bezeichnung Ihres Quell-Repositorys (**WorkflowSource**) und die Build-Aktion (z. B. **build\$1F0**) zeigt.

1. **Wählen Sie im Workflow-Ausführungsdiagramm die Build-Aktion aus (z. B. build\$1F0).**

1. **Überprüfen Sie den Inhalt der **Registerkarten Protokolle**, **Berichte**, **Konfiguration** und Variablen.** Auf diesen Registerkarten werden die Ergebnisse Ihrer Build-Aktion angezeigt.

   Weitere Informationen finden Sie unter [Ergebnisse einer Build-Aktion anzeigen](build-view-results.md).

## (Optional) Schritt 4: Bereinigen
<a name="get-started-create-workflow-cleanup"></a>

In diesem Schritt bereinigen Sie die Ressourcen, die Sie in diesem Tutorial erstellt haben.

**Um Ressourcen zu löschen**
+ Wenn Sie für dieses Tutorial ein neues Projekt erstellt haben, löschen Sie es. Detaillierte Anweisungen finden Sie unter [Löschen eines Projekts](projects-delete.md). Durch das Löschen des Projekts werden auch das Quell-Repository und der Workflow gelöscht.