

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.

# Artefakte und Dateien zwischen Aktionen teilen
<a name="workflows-working-artifacts"></a>

Ein *Artefakt* ist die Ausgabe einer Workflow-Aktion und besteht in der Regel aus einem Ordner oder Archiv mit Dateien. Artefakte sind wichtig, weil sie es Ihnen ermöglichen, Dateien und Informationen zwischen Aktionen gemeinsam zu nutzen.

Möglicherweise haben Sie eine Build-Aktion, die eine `sam-template.yml` Datei *generiert*, Sie möchten jedoch, dass eine Bereitstellungsaktion *diese verwendet*. In diesem Szenario würden Sie ein Artefakt verwenden, um es der Build-Aktion zu ermöglichen, die `sam-template.yml` Datei mit der Bereitstellungsaktion gemeinsam zu nutzen. Der Code könnte etwa so aussehen:

```
Actions:
  BuildAction:
    Identifier: aws/build@v1
    Steps:
      - Run: sam package --output-template-file sam-template.yml
    Outputs:
      Artifacts:
        - Name: MYARTIFACT
          Files:
            - sam-template.yml
  DeployAction:
    Identifier: aws/cfn-deploy@v1  
    Inputs:
      Artifacts:
        - MYARTIFACT
    Configuration:
      template: sam-template.yml
```

Im vorherigen Code generiert die Build-Aktion (`BuildAction`) eine `sam-template.yml` Datei und fügt sie dann einem Ausgabeartefakt namens `MYARTIFACT` hinzu. Eine nachfolgende Bereitstellungsaktion (`DeployAction`) wird `MYARTIFACT` als Eingabe angegeben, sodass sie auf die `sam-template.yml` Datei zugreifen kann.

**Topics**
+ [Kann ich Artefakte teilen, ohne sie als Ausgaben und Eingaben anzugeben?](#workflows-working-artifacts-share)
+ [Kann ich Artefakte zwischen Workflows teilen?](#workflows-working-artifacts-share-wf)
+ [Beispiele für Artefakte](workflows-working-artifacts-ex.md)
+ [Definition eines Ausgabeartefakts](workflows-working-artifacts-output.md)
+ [Definition eines Eingabeartefakts](workflows-working-artifacts-refer.md)
+ [Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.md)
+ [Artefakte herunterladen](workflows-download-workflow-outputs.md)

## Kann ich Artefakte teilen, ohne sie als Ausgaben und Eingaben anzugeben?
<a name="workflows-working-artifacts-share"></a>

Ja, Sie können Artefakte zwischen Aktionen gemeinsam nutzen, ohne sie in den `Inputs` Abschnitten `Outputs` und im YAML-Code Ihrer Aktionen anzugeben. Dazu müssen Sie Compute Sharing aktivieren. Weitere Informationen zu Compute Sharing und zur Angabe von Artefakten, wenn es aktiviert ist, finden Sie unter[Rechenleistung für mehrere Aktionen gemeinsam nutzen](compute-sharing.md). 

**Anmerkung**  
Mit der Compute Sharing-Funktion können Sie zwar den YAML-Code Ihres Workflows vereinfachen, indem Sie die `Inputs` Abschnitte `Outputs` und und überflüssig machen, es gibt jedoch Einschränkungen, die Sie beachten sollten, bevor Sie sie aktivieren. Informationen zu diesen Einschränkungen finden Sie unter[Überlegungen zur gemeinsamen Nutzung von Rechenleistung](compute-sharing.md#compare-compute-sharing).

## Kann ich Artefakte zwischen Workflows teilen?
<a name="workflows-working-artifacts-share-wf"></a>

Nein, Sie können Artefakte nicht zwischen verschiedenen Workflows gemeinsam nutzen. Sie können Artefakte jedoch zwischen Aktionen innerhalb desselben Workflows gemeinsam nutzen.

# Beispiele für Artefakte
<a name="workflows-working-artifacts-ex"></a>

Die folgenden Beispiele zeigen, wie Artefakte in der CodeCatalyst Amazon-Workflow-Definitionsdatei ausgegeben, eingegeben und referenziert werden.

**Topics**
+ [Beispiel: Ausgabe eines Artefakts](#workflows-working-artifacts-ex-basic)
+ [Beispiel: Eingabe eines Artefakts, das durch eine andere Aktion generiert wurde](#workflows-working-artifacts-ex-ref)
+ [Beispiel: Referenzieren von Dateien in mehreren Artefakten](#workflows-working-artifacts-ex-ref-file)
+ [Beispiel: Referenzieren einer Datei in einem einzigen Artefakt](#workflows-working-artifacts-ex-ref-file-one)
+ [Beispiel: Verweisen auf eine Datei in einem Artefakt, wenn a vorhanden ist WorkflowSource](#workflows-working-artifacts-ex-ref-file-wf-source)
+ [Beispiel: Referenzieren einer Datei in einem Artefakt, wenn eine Aktionsgruppe vorhanden ist](#workflows-working-artifacts-ex-groups)

## Beispiel: Ausgabe eines Artefakts
<a name="workflows-working-artifacts-ex-basic"></a>

Das folgende Beispiel zeigt, wie ein Artefakt ausgegeben wird, das zwei .jar-Dateien enthält.

```
Actions:
  Build:
    Identifier: aws/build@v1
    Outputs:
      Artifacts:
        - Name: ARTIFACT1
          Files:
            - build-output/file1.jar
            - build-output/file2.jar
```

## Beispiel: Eingabe eines Artefakts, das durch eine andere Aktion generiert wurde
<a name="workflows-working-artifacts-ex-ref"></a>

Das folgende Beispiel zeigt Ihnen, wie Sie ein aufgerufenes Artefakt ausgeben und `ARTIFACT4` in `BuildActionA` dieses eingeben. `BuildActionB`

```
Actions:
  BuildActionA:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ARTIFACT4
          Files:
            - build-output/file1.jar
            - build-output/file2.jar
  BuildActionB:
    Identifier: aws/build@v1  
    Inputs:
      Artifacts:
        - ARTIFACT4
    Configuration:
```

## Beispiel: Referenzieren von Dateien in mehreren Artefakten
<a name="workflows-working-artifacts-ex-ref-file"></a>

Das folgende Beispiel zeigt`BuildActionC`, wie Sie zwei Artefakte mit dem Namen `ART5` und `ART6` in ausgeben und dann auf zwei Dateien mit den Namen `file5.txt` (in Artifact`ART5`) und `file6.txt` (in Artifact`ART6`) in `BuildActionD` (unter`Steps`) verweisen.

**Anmerkung**  
Weitere Informationen zum Referenzieren von Dateien finden Sie unter. [Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.md)

**Anmerkung**  
Das Beispiel zeigt zwar, dass das `$CATALYST_SOURCE_DIR_ART5` Präfix verwendet wird, Sie könnten es aber weglassen. Das liegt daran, dass `ART5` es die *primäre Eingabe* ist. Weitere Informationen zur primären Eingabe finden Sie unter[Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.md). 

```
Actions:
  BuildActionC:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ART5
          Files:
            - build-output/file5.txt
        - Name: ART6
          Files:
            - build-output/file6.txt
  BuildActionD:
    Identifier: aws/build@v1  
    Inputs:
      Artifacts:
        - ART5
        - ART6
    Configuration:
      Steps:
        - run: cd $CATALYST_SOURCE_DIR_ART5/build-output && cat file5.txt
        - run: cd $CATALYST_SOURCE_DIR_ART6/build-output && cat file6.txt
```

## Beispiel: Referenzieren einer Datei in einem einzigen Artefakt
<a name="workflows-working-artifacts-ex-ref-file-one"></a>

Das folgende Beispiel zeigt, wie Sie ein Artefakt mit dem Namen `ART7` in `BuildActionE` ausgeben und dann auf `file7.txt` (im Artefakt`ART7`) in `BuildActionF` (unter) verweisen. `Steps`

Beachten Sie, dass für die Referenz kein `$CATALYST_SOURCE_DIR_` *artifact-name* Präfix vor dem `build-output` Verzeichnis erforderlich ist, wie dies in der Fall war. [Beispiel: Referenzieren von Dateien in mehreren Artefakten](#workflows-working-artifacts-ex-ref-file) Dies liegt daran, dass unter nur ein Element angegeben ist`Inputs`.

**Anmerkung**  
Weitere Informationen zum Verweisen auf Dateien finden Sie unter[Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.md).

```
Actions:
  BuildActionE:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ART7
          Files:
            - build-output/file7.txt
  BuildActionF:
    Identifier: aws/build@v1  
    Inputs:
      Artifacts:
        - ART7
    Configuration:
      Steps:
        - run: cd build-output && cat file7.txt
```

## Beispiel: Verweisen auf eine Datei in einem Artefakt, wenn a vorhanden ist WorkflowSource
<a name="workflows-working-artifacts-ex-ref-file-wf-source"></a>

Das folgende Beispiel zeigt, wie Sie ein Artefakt mit dem Namen `ART8` in `BuildActionG` ausgeben und dann auf `file8.txt` (in Artefakt`ART8`) in `BuildActionH` (unter) verweisen. `Steps`

Beachten Sie, dass für die Referenz das `$CATALYST_SOURCE_DIR_` *artifact-name* Präfix erforderlich ist, wie in. [Beispiel: Referenzieren von Dateien in mehreren Artefakten](#workflows-working-artifacts-ex-ref-file) Das liegt daran, dass unter `Inputs` (eine Quelle und ein Artefakt) mehrere Elemente angegeben sind. Sie benötigen also das Präfix, um anzugeben, wo nach der Datei gesucht werden soll.

**Anmerkung**  
Weitere Informationen zum Verweisen auf Dateien finden Sie unter. [Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.md)

```
Actions:
  BuildActionG:
    Identifier: aws/build@v1  
    Outputs:
      Artifacts:
        - Name: ART8
          Files:
            - build-output/file8.txt
  BuildActionH:
    Identifier: aws/build@v1  
    Inputs:
      Sources:
        - WorkflowSource
      Artifacts:
        - ART8
    Configuration:
      Steps:
        - run: cd $CATALYST_SOURCE_DIR_ART8/build-output && cat file8.txt
```

## Beispiel: Referenzieren einer Datei in einem Artefakt, wenn eine Aktionsgruppe vorhanden ist
<a name="workflows-working-artifacts-ex-groups"></a>

Das folgende Beispiel zeigt, wie Sie ein Artefakt mit dem Namen `ART9` in `ActionGroup1` ausgeben und dann `file9.txt` (im Artefakt`ART9`) in referenzieren. `ActionI` `ActionJ`

Weitere Informationen zum Verweisen auf Dateien finden Sie unter. [Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.md)

```
Actions:
  ActionGroup1:
    Actions:
      ActionI:
        Identifier: aws/build@v1
        Outputs:
          Artifacts:
            - Name: ART9
              Files:
                - build-output/file9.yml
      ActionJ:
        Identifier: aws/cfn-deploy@v1 
        Inputs:
          Sources:
            - WorkflowSource
          Artifacts:
            - ART9
        Configuration:
          template: /artifacts/ActionGroup1@ActionJ/ART9/build-output/file9.yml
```

# Definition eines Ausgabeartefakts
<a name="workflows-working-artifacts-output"></a>

Verwenden Sie die folgenden Anweisungen, um ein Artefakt zu definieren, das eine CodeCatalyst Amazon-Aktion ausgeben soll. Dieses Artefakt steht dann für andere Aktionen zur Verfügung.

**Anmerkung**  
Nicht alle Aktionen unterstützen Ausgabeartefakte. Um festzustellen, ob Ihre Aktion sie unterstützt, führen Sie die folgenden Anweisungen für den visuellen Editor durch und prüfen Sie, ob die Aktion auf der Registerkarte **Ausgaben** die Schaltfläche **Ausgabeartefakte** enthält. Falls ja, werden Ausgabeartefakte unterstützt. 

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

**Um ein Ausgabeartefakt mit dem visuellen Editor zu definieren**

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, die das Artefakt erzeugen soll.

1. Wählen Sie die Registerkarte **Outputs**.

1. Wählen Sie unter **Artefakte** die Option **Artefakt hinzufügen** aus.

1. Wählen Sie „**Artefakt hinzufügen**“ und geben Sie wie folgt Informationen in die Felder ein.

    **Name des Build-Artefakts** 

   Geben Sie den Namen eines Artefakts an, das durch die Aktion generiert wurde. Artefaktnamen müssen innerhalb eines Workflows eindeutig sein und sind auf alphanumerische Zeichen (a-z, A-Z, 0-9) und Unterstriche (\$1) beschränkt. Leerzeichen, Bindestriche (-) und andere Sonderzeichen sind nicht zulässig. Sie können keine Anführungszeichen verwenden, um Leerzeichen, Bindestriche und andere Sonderzeichen in Namen von Ausgabeartefakten zuzulassen.

   Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter. [Artefakte und Dateien zwischen Aktionen teilen](workflows-working-artifacts.md)

    **Dateien, die von Build erstellt wurden** 

   Geben Sie die Dateien an, die in dem Artefakt CodeCatalyst enthalten sind, das durch die Aktion ausgegeben wird. Diese Dateien werden durch die Workflow-Aktion generiert, wenn sie ausgeführt wird, und sind auch in Ihrem Quell-Repository verfügbar. Dateipfade können sich in einem Quell-Repository oder einem Artefakt aus einer früheren Aktion befinden und sind relativ zum Quell-Repository oder Artefakt-Stamm. Sie können Glob-Muster verwenden, um Pfade anzugeben. Beispiele:
   + Um eine einzelne Datei anzugeben, die sich im Stammverzeichnis Ihres Build-Speicherorts oder Quell-Repository-Speicherorts befindet, verwenden Sie`my-file.jar`.
   + Um eine einzelne Datei in einem Unterverzeichnis anzugeben, verwenden Sie `directory/my-file.jar` oder`directory/subdirectory/my-file.jar`.
   + Um alle Dateien anzugeben, verwenden Sie`"**/*"`. Das `**` Glob-Muster gibt an, dass es einer beliebigen Anzahl von Unterverzeichnissen entspricht.
   + Um alle Dateien und Verzeichnisse in einem Verzeichnis mit dem Namen anzugeben`directory`, verwenden Sie. `"directory/**/*"` Das `**` Glob-Muster gibt an, dass es einer beliebigen Anzahl von Unterverzeichnissen entspricht.
   + Um alle Dateien in einem Verzeichnis mit dem Namen`directory`, aber nicht in einem seiner Unterverzeichnisse anzugeben, verwenden Sie. `"directory/*"` 
**Anmerkung**  
Wenn Ihr Dateipfad ein oder mehrere Sternchen (`*`) oder ein anderes Sonderzeichen enthält, schließen Sie den Pfad in doppelte Anführungszeichen () ein. `""` Weitere Hinweise zu Sonderzeichen finden Sie unter. [Richtlinien und Konventionen zur Syntax](workflow-reference.md#workflow.terms.syntax.conv)

   Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter[Artefakte und Dateien zwischen Aktionen teilen](workflows-working-artifacts.md).
**Anmerkung**  
Möglicherweise müssen Sie dem Dateipfad ein Präfix hinzufügen, um anzugeben, in welchem Artefakt oder in welcher Quelle das Objekt gefunden werden soll. Weitere Informationen erhalten Sie unter [Quell-Repository-Dateien referenzieren](workflows-sources-reference-files.md) und [Referenzieren von Dateien in einem Artefakt](workflows-working-artifacts-refer-files.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 ein Ausgabeartefakt mit dem YAML-Editor zu definieren**

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 Workflow-Aktion Code hinzu, der dem folgenden ähnelt:

   ```
   action-name:
     Outputs:
       Artifacts:
         - Name: artifact-name
           Files:
             - file-path-1
             - file-path-2
   ```

   Weitere Beispiele finden Sie unter [Beispiele für Artefakte](workflows-working-artifacts-ex.md). Weitere Informationen finden Sie 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**.

------

# Definition eines Eingabeartefakts
<a name="workflows-working-artifacts-refer"></a>

Wenn Sie ein Artefakt verwenden möchten, das durch eine andere CodeCatalyst Amazon-Aktion generiert wurde, müssen Sie es als Eingabe für die aktuelle Aktion angeben. Möglicherweise können Sie mehrere Artefakte als Eingabe angeben — das hängt von der Aktion ab. Weitere Informationen finden Sie unter [YAML-Workflow-Definition](workflow-reference.md) Für Ihre Aktion.

**Anmerkung**  
Sie können nicht auf Artefakte aus anderen Workflows verweisen.

Verwenden Sie die folgenden Anweisungen, um ein Artefakt aus einer anderen Aktion als Eingabe für die aktuelle Aktion anzugeben.

**Voraussetzung**  
Bevor Sie beginnen, stellen Sie sicher, dass Sie das Artefakt aus der anderen Aktion ausgegeben haben. Weitere Informationen finden Sie unter [Definition eines Ausgabeartefakts](workflows-working-artifacts-output.md). Wenn Sie das Artefakt ausgeben, steht es anderen Aktionen zur Verfügung.

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

**Um ein Artefakt als Eingabe für eine Aktion anzugeben (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 ein Artefakt als Eingabe angeben möchten.

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

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

   Geben Sie Artefakte aus früheren Aktionen an, die Sie als Eingabe für diese Aktion bereitstellen möchten. Diese Artefakte müssen bereits in früheren Aktionen als Ausgabeartefakte definiert sein.

   Wenn Sie keine Eingabeartefakte angeben, müssen Sie mindestens ein Quell-Repository unter angeben`action-name/Inputs/Sources`.

   Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter[Artefakte und Dateien zwischen Aktionen teilen](workflows-working-artifacts.md).
**Anmerkung**  
Wenn die Dropdownliste **Artefakte — optional** nicht verfügbar ist (visueller Editor) oder wenn Sie bei der Validierung Ihres YAML (YAML-Editors) Fehler erhalten, kann das daran liegen, dass die Aktion nur eine Eingabe unterstützt. Versuchen Sie in diesem Fall, die Quelleingabe zu entfernen.

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 ein Artefakt als Eingabe für eine Aktion anzugeben (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 der Aktion, in der Sie das Artefakt als Eingabe angeben möchten, Code hinzu, der dem folgenden ähnelt:

   ```
   action-name:
     Inputs:
       Artifacts:
         - artifact-name
   ```

   Weitere Beispiele finden Sie unter [Beispiele für Artefakte](workflows-working-artifacts-ex.md).

1. (Optional) Wählen Sie **Validieren** aus, 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**.

------

# Referenzieren von Dateien in einem Artefakt
<a name="workflows-working-artifacts-refer-files"></a>

Wenn Sie eine Datei haben, die sich in einem Artefakt befindet, und Sie in einer Ihrer CodeCatalyst Amazon-Workflow-Aktionen auf diese Datei verweisen müssen, gehen Sie wie folgt vor.

**Anmerkung**  
Siehe auch [Quell-Repository-Dateien referenzieren](workflows-sources-reference-files.md).

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

*Nicht verfügbar. Wählen Sie YAML, um die YAML-Anweisungen anzuzeigen.*

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

**Um Dateien in einem Artefakt zu referenzieren (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 der Aktion, in der Sie auf eine Datei verweisen möchten, Code hinzu, der dem folgenden ähnelt:

   ```
   Actions:
     My-action:
       Inputs:
         Sources:
           - WorkflowSource
         Artifacts:
           - artifact-name  
       Configuration:
         template: artifact-path/path/to/file.yml
   ```

   Ersetzen Sie im vorherigen Code:
   + *artifact-name*mit dem Namen des Artefakts.
   + *artifact-path*mit einem Wert aus der folgenden Tabelle.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codecatalyst/latest/userguide/workflows-working-artifacts-refer-files.html)

   Beispiele finden Sie unter [Beispiele für Artefakte](workflows-working-artifacts-ex.md).
**Anmerkung**  
Sie können das weglassen *artifact-path* und einfach den Dateipfad relativ zum Artefakt-Stammverzeichnis angeben, wenn:  
Die Aktion, bei der Sie die Referenz angeben, umfasst nur ein Element unter `Inputs` (z. B. ein Eingabeartefakt und keine Quelle).
Die Datei, auf die Sie verweisen möchten, befindet sich in der primären Eingabe. Die *primäre Eingabe* ist entweder das `WorkflowSource` oder das erste aufgeführte Eingabeartefakt, falls keines vorhanden ist. `WorkflowSource`

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

------

# Artefakte herunterladen
<a name="workflows-download-workflow-outputs"></a>

Sie können Artefakte, die durch Ihre CodeCatalyst Amazon-Workflow-Aktionen generiert wurden, zur Fehlerbehebung herunterladen und überprüfen. Es gibt zwei Arten von Artefakten, die Sie herunterladen können:
+ **Quellartefakte** — Ein Artefakt, das einen Snapshot des Inhalts des Quell-Repositorys enthält, so wie er zu Beginn der Ausführung vorhanden war.
+ **Workflow-Artefakte** — Ein Artefakt, das in der `Outputs` Eigenschaft der Konfigurationsdatei Ihres Workflows definiert ist.

**Um die vom Workflow ausgegebenen Artefakte herunterzuladen**

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 unter dem Namen des Workflows die Option **Läufe** aus.

1. Wählen **Sie im Ausführungsverlauf** in der Spalte **Lauf-ID** einen Lauf aus. Beispiel, `Run-95a4d`.

1. Wählen Sie unter dem Namen des Laufs die Option **Artifacts** aus.

1. Wähle neben einem Artefakt die Option **Herunterladen** aus. Eine Archivdatei wird heruntergeladen. Ihr Dateiname besteht aus sieben zufälligen Zeichen.

1. Extrahieren Sie das Archiv mit einem Archivextraktionsprogramm Ihrer Wahl.