

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.

# Quell-Repositorys mit Workflows verbinden
<a name="workflows-sources"></a>

Eine *Quelle*, auch *Eingabequelle* genannt, ist ein Quell-Repository, mit dem eine [Workflow-Aktion](workflows-actions.md) eine Verbindung herstellt, um die Dateien abzurufen, die sie für ihre Operationen benötigt. Beispielsweise kann eine Workflow-Aktion eine Verbindung zu einem Quell-Repository herstellen, um Anwendungsquelldateien für die Erstellung einer Anwendung abzurufen.

CodeCatalyst Workflows unterstützen die folgenden Quellen:
+ CodeCatalyst Quell-Repositorys — Weitere Informationen finden Sie unter[Speichern Sie Code mit Quell-Repositorys in und arbeiten Sie gemeinsam daran CodeCatalystSpeichern Sie Code mit Quell-Repositorys und arbeiten Sie gemeinsam daran](source.md).
+ GitHub Repositorys, Bitbucket-Repositorys und GitLab Projekt-Repositorys — Weitere Informationen findest du unter. [Fügen Sie Funktionen zu Projekten mit Erweiterungen hinzu in CodeCatalystFügen Sie Funktionen zu Projekten mit Erweiterungen hinzu](extensions.md)

**Topics**
+ [Quell-Repository einer Workflow-Datei angeben](workflows-sources-specify-workflow-def.md)
+ [Quell-Repository einer Workflow-Aktion angeben](workflows-sources-specify-action.md)
+ [Quell-Repository-Dateien referenzieren](workflows-sources-reference-files.md)
+ [Variablen BranchName '' und CommitId ''](workflows-sources-variables.md)

# Quell-Repository einer Workflow-Datei angeben
<a name="workflows-sources-specify-workflow-def"></a>

Verwenden Sie die folgenden Anweisungen, um das CodeCatalyst Quell-Repository anzugeben, in dem Sie Ihre Workflow-Definitionsdatei speichern möchten. Wenn du lieber ein GitHub Repository, Bitbucket-Repository oder GitLab Projekt-Repository angeben möchtest, siehe stattdessen[Fügen Sie Funktionen zu Projekten mit Erweiterungen hinzu in CodeCatalystFügen Sie Funktionen zu Projekten mit Erweiterungen hinzu](extensions.md).

Das Quell-Repository, in dem sich deine Workflow-Definitionsdatei befindet, ist durch das Label, gekennzeichnet. `WorkflowSource`

**Anmerkung**  
Sie geben das Quell-Repository an, in dem sich Ihre Workflow-Definitionsdatei befindet, wenn Sie Ihre Workflow-Definitionsdatei zum ersten Mal übertragen. Nach diesem Commit sind das Repository und die Workflow-Definitionsdatei dauerhaft miteinander verknüpft. Die einzige Möglichkeit, das Repository nach dem ersten Commit zu ändern, besteht darin, den Workflow in einem anderen Repository neu zu erstellen.

**Um das Quell-Repository anzugeben, in dem die Workflow-Definitionsdatei gespeichert werden soll**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie Ihr Projekt.

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

1. Wählen Sie **Workflow erstellen** und erstellen Sie den Workflow. Weitere Informationen finden Sie unter [Einen Workflow erstellen](workflows-create-workflow.md).

   Während der Workflow-Erstellung können Sie das CodeCatalyst Repository, den Zweig und den Ordner angeben, in dem Sie Ihre Workflow-Definitionsdatei speichern möchten.

# Quell-Repository einer Workflow-Aktion angeben
<a name="workflows-sources-specify-action"></a>

Verwenden Sie die folgenden Anweisungen, um ein Quell-Repository anzugeben, das mit einer Workflow-Aktion verwendet werden soll. Beim Start bündelt die Aktion die Dateien im konfigurierten Quell-Repository zu einem Artefakt, lädt das Artefakt in das [Docker-Image der Laufzeitumgebung](build-images.md) herunter, in dem die Aktion ausgeführt wird, und schließt dann die Verarbeitung mit den heruntergeladenen Dateien ab.

**Anmerkung**  
Derzeit können Sie innerhalb einer Workflow-Aktion nur ein Quell-Repository angeben, nämlich das Quell-Repository, in dem sich die Workflow-Definitionsdatei befindet (im `.codecatalyst/workflows/` Verzeichnis oder einem seiner Unterverzeichnisse). Dieses Quell-Repository wird durch das Label dargestellt. `WorkflowSource`

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

**Um das Quell-Repository anzugeben, das eine Aktion verwenden soll (visueller Editor)**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie Ihr Projekt.

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

1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

1. Wählen Sie **Bearbeiten** aus.

1. Wählen Sie **Visual**.

1. Wählen Sie im Workflow-Diagramm die Aktion aus, für die Sie die Quelle angeben möchten.

1. Wählen Sie **Eingaben**.

1. Gehen Sie **unter Quellen — optional** wie folgt vor:

   Geben Sie die Labels an, die die Quell-Repositorys repräsentieren, die für die Aktion benötigt werden. Derzeit wird nur die Bezeichnung, die das Quell-Repository darstellt`WorkflowSource`, in dem Ihre Workflow-Definitionsdatei gespeichert ist, unterstützt.

   Wenn Sie eine Quelle weglassen, müssen Sie mindestens ein Eingabeartefakt unter angeben. `action-name/Inputs/Artifacts`

   Weitere Informationen zu Quellen finden Sie unter [Quell-Repositorys mit Workflows verbinden](workflows-sources.md).

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

------
#### [ YAML ]

**Um das Quell-Repository anzugeben, das eine Aktion verwenden soll (YAML-Editor)**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie Ihr Projekt.

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

1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

1. Wählen Sie **Bearbeiten** aus.

1. Wählen Sie **YAML.**

1. Fügen Sie in einer Aktion Code hinzu, der dem folgenden ähnelt:

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

   Weitere Informationen finden Sie in der Beschreibung der `Sources` Eigenschaft unter [YAML-Workflow-Definition](workflow-reference.md) Für Ihre Aktion.

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

------

# Quell-Repository-Dateien referenzieren
<a name="workflows-sources-reference-files"></a>

Wenn Sie über Dateien verfügen, die sich in einem Quell-Repository befinden, und Sie in einer Ihrer Workflow-Aktionen auf diese Dateien verweisen müssen, gehen Sie wie folgt vor.

**Anmerkung**  
Siehe auch [Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.md).

**Um auf eine Datei zu verweisen, die in einem Quell-Repository gespeichert ist**
+ Fügen Sie in der Aktion, in der Sie auf eine Datei verweisen möchten, Code hinzu, der dem folgenden ähnelt:

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

  Im vorherigen Code sucht die Aktion im Verzeichnis im `my-app` Stammverzeichnis des `WorkflowSource` Quell-Repositorys nach der `file1.jar` Datei und zeigt sie an.

# Variablen BranchName '' und CommitId ''
<a name="workflows-sources-variables"></a>

Die CodeCatalyst Quelle erzeugt `BranchName` und legt `CommitId` Variablen fest, wenn Ihr Workflow ausgeführt wird. Diese werden als *vordefinierte Variablen* bezeichnet. In der folgenden Tabelle finden Sie Informationen zu diesen Variablen.

Informationen zum Verweisen auf diese Variablen in einem Workflow finden Sie unter[Verwenden vordefinierter Variablen](workflows-using-predefined-variables.md).


| Key (Schlüssel) | Value (Wert) | 
| --- | --- | 
|  CommitId  |  Die Commit-ID, die den Status des Repositorys zum Zeitpunkt des Starts der Workflow-Ausführung darstellt. Beispiel: `example3819261db00a3ab59468c8b` Weitere Informationen finden Sie auch unter: [Beispiel: Verweisen auf die vordefinierte CommitId Variable ""](workflows-predefined-examples.md#workflows-working-with-variables-ex-refer-action).  | 
|  BranchName  |  Der Name des Branches, für den die Workflow-Ausführung gestartet wurde. Beispiele: `main`, `feature/branch`, `test-LiJuan`. Weitere Informationen finden Sie auch unter: [Beispiel: Verweisen auf die vordefinierte BranchName Variable ""](workflows-predefined-examples.md#workflows-working-with-variables-ex-branch).  | 