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.

# Tutorial: Erstellen Sie eine Pipeline, die Befehle mit Compute ausführt (Typ V2)
<a name="tutorials-commands"></a>

In diesem Tutorial konfigurieren Sie mithilfe der Aktion Befehle in einer Buildphase eine Pipeline, die kontinuierlich bereitgestellte Build-Befehle ausführt. Weitere Informationen zur Aktion „Befehle“ finden Sie unter[Aktionsreferenz für Befehle](action-reference-Commands.md).

**Wichtig**  
Im Rahmen der Erstellung einer Pipeline wird ein vom Kunden bereitgestellter S3-Artefakt-Bucket von CodePipeline for Artifacts verwendet. (Dies unterscheidet sich von dem Bucket, der für eine S3-Quellaktion verwendet wird.) Wenn sich der S3-Artefakt-Bucket in einem anderen Konto befindet als das Konto für Ihre Pipeline, stellen Sie sicher, dass der S3-Artefakt-Bucket denjenigen gehört AWS-Konten , die sicher und zuverlässig sind.

## Voraussetzungen
<a name="tutorials-commands-prereq"></a>

Sie müssen bereits über Folgendes verfügen:
+ Ein GitHub Repository. Sie können das GitHub Repository verwenden, in dem Sie es erstellt haben[Tutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden](tutorials-github-gitclone.md).

## Schritt 1: Erstellen Sie Quelldateien und übertragen Sie sie in Ihr GitHub Repository
<a name="tutorials-commands-push"></a>

In diesem Abschnitt erstellen Sie Ihre Beispielquelldateien und übertragen sie in das Repository, das die Pipeline für Ihre Quellphase verwendet. Für dieses Beispiel produzieren Sie Folgendes und übertragen es: 
+ Die Datei `README.txt`.

**Um Quelldateien zu erstellen**

1. Erstellen Sie eine Datei mit dem folgenden Text:

   ```
   Sample readme file
   ```

1. Speichern Sie die Datei als `README.txt`.

**Um Dateien in Ihr GitHub Repository zu übertragen**

1. Übertragen Sie die Dateien per Push an Ihr -Repository oder laden Sie sie hoch. Diese Dateien stellen das Quellartefakt dar, das vom Assistenten **Create Pipeline (Pipeline erstellen)** für Ihre Bereitstellungsaktion in AWS CodePipeline erstellt wurde. Ihre Dateien sollten in Ihrem lokalen Verzeichnis wie folgt aussehen:

   ```
   README.txt
   ```

1. So verwenden Sie die Git-Befehlszeile aus einem geklonten Repository auf Ihrem lokalen Computer:

   1. Führen Sie den folgenden Befehl aus, um alle Dateien auf einmal zu übertragen:

      ```
      git add -A
      ```

   1. Führen Sie den folgenden Befehl aus, um die Dateien mit einer Commit-Nachricht zu übertragen.

      ```
      git commit -m "Added source files"
      ```

   1. Führen Sie den folgenden Befehl aus, um die Dateien aus Ihrem lokalen Repository in Ihr -Repository zu übertragen:

      ```
      git push
      ```

## Schritt 2: Erstellen der Pipeline
<a name="tutorials-commands-pipeline"></a>

In diesem Abschnitt erstellen Sie eine Pipeline mit den folgenden Aktionen:
+ Eine Quellstufe mit einer Aktion GitHub (über GitHub App) für das Repository, in dem die Quelldateien gespeichert sind.
+ Eine Build-Phase mit der Aktion „Befehle“.

**So erstellen Sie mit dem Assistenten eine Pipeline**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodePipeline Konsole unter [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Wählen sie auf der Seite **Welcome (Willkommen)** die Option **Getting started (Erste Schritte)** aus, oder auf der Seite **Pipelines** die Option **Create pipeline (Pipeline erstellen)**.

1. Wählen Sie auf der Seite **Schritt 1: Erstellungsoption auswählen** unter **Erstellungsoptionen** die Option **Benutzerdefinierte Pipeline erstellen** aus. Wählen Sie **Weiter** aus.

1. Geben Sie in **Schritt 2: Pipeline-Einstellungen auswählen** im Feld **Pipeline-Name** den Wert ein**MyCommandsPipeline**.

1. CodePipeline bietet Pipelines vom Typ V1 und V2, die sich in Eigenschaften und Preis unterscheiden. Der Typ V2 ist der einzige Typ, den Sie in der Konsole auswählen können. Weitere Informationen finden Sie unter [Pipeline-Typen](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Informationen zur Preisgestaltung für finden Sie CodePipeline unter [Preisgestaltung](https://aws.amazon.com/codepipeline/pricing/).

1. Wählen Sie unter **Servicerolle** die Option **Neue Servicerolle** aus, um CodePipeline die Erstellung einer Servicerolle in IAM zu ermöglichen.
**Anmerkung**  
Wenn Sie eine vorhandene Servicerolle verwenden, müssen Sie zur Verwendung der Aktion Befehle die folgenden Berechtigungen für die Servicerolle hinzufügen. Beschränken Sie die Berechtigungen auf die Ebene der Pipeline-Ressourcen, indem Sie die ressourcenbasierten Berechtigungen in der Richtlinienanweisung für die Servicerolle verwenden. Weitere Informationen finden Sie im Richtlinienbeispiel unter. [Richtlinienberechtigungen für die Servicerolle](action-reference-Commands.md#action-reference-Commands-policy)  
Protokolle: CreateLogGroup
Protokolle: CreateLogStream
Protokolle: PutLogEvents

1. Belassen Sie die Einstellungen unter **Erweiterte Einstellungen** bei den Standardeinstellungen, und wählen Sie dann **Next (Weiter)** aus.

1. **Fügen Sie auf der Seite Schritt 3: Quell-Stagingbereich** hinzufügen einen Quell-Stagingbereich hinzu:

   1. Wählen Sie **unter Quellanbieter** die Option **GitHub (über GitHub App)** aus.

   1. Wählen Sie unter **Verbindung** eine bestehende Verbindung aus oder erstellen Sie eine neue. Informationen zum Erstellen oder Verwalten einer Verbindung für Ihre GitHub Quellaktion finden Sie unter[GitHub Verbindungen](connections-github.md).

   1. Wählen Sie unter **Repository-Name** den Namen Ihres GitHub .com-Repositorys aus. 

   1. Wählen Sie **unter Standardzweig** den Branch aus, den Sie angeben möchten, wenn die Pipeline manuell oder mit einem Quellereignis gestartet wird, das kein Git-Tag ist. Wenn die Quelle der Änderung nicht der Auslöser ist oder wenn eine Pipeline-Ausführung manuell gestartet wurde, wird als Änderung der HEAD-Commit aus dem Standardbranch verwendet. Optional können Sie auch Webhooks mit Filterung (Trigger) angeben. Weitere Informationen finden Sie unter [Automatisieren Sie das Starten von Pipelines mithilfe von Triggern und Filtern](pipelines-triggers.md).

   Wählen Sie **Weiter** aus.

1. Wählen Sie in **Schritt 4: Build-Phase hinzufügen** die Option **Befehle** aus.
**Anmerkung**  
Für die Ausführung der Aktion „Befehle“ fallen separate Gebühren in an AWS CodeBuild.

   Geben Sie die folgenden Befehle ein. 

   ```
   ls
   echo hello world
   cat README.txt
   echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}
   ```

   Wählen Sie **Weiter** aus.  
![\[Die Seite „Schritt 4: Build-Phase hinzufügen“ für eine neue Pipeline mit der Aktion „Befehle“\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/commands-wizard-screen.png)

1. Wählen Sie in **Schritt 5: Testphase hinzufügen** die Option **Testphase überspringen** aus und akzeptieren Sie dann die Warnmeldung, indem Sie erneut **Überspringen** wählen. 

   Wählen Sie **Weiter** aus.

1. Wählen Sie in **Schritt 6: Bereitstellungsphase hinzufügen** die Option **Bereitstellungsphase überspringen** aus und akzeptieren Sie dann die Warnmeldung, indem Sie erneut **Überspringen** auswählen. 

   Wählen Sie **Weiter** aus.

1. Überprüfen **Sie in Schritt 7: Überprüfen** Sie die Informationen und wählen Sie dann **Pipeline erstellen** aus.

1. Als letzten Schritt beim Erstellen Ihrer Aktion fügen Sie der Aktion eine Umgebungsvariable hinzu, die zu einer Ausgabevariablen für die Aktion führt. Wählen Sie in der Aktion Befehle die Option **Bearbeiten** aus. Geben Sie auf dem **Bearbeitungsbildschirm** einen Variablennamespace für Ihre Aktion an, indem Sie ihn `compute` in das Feld **Variablennamespace** eingeben.

   Fügen Sie die CodeBuild Ausgabevariable `AWS_Default_Region` hinzu und wählen Sie dann Variable **hinzufügen**.  
![\[Die Seite „Bearbeiten“ für die Aktion „Befehle“\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/commands-output-edit-var.png)

## Schritt 3: Führen Sie Ihre Pipeline aus und überprüfen Sie die Build-Befehle
<a name="tutorials-commands-update"></a>

Geben Sie eine Änderung frei, um Ihre Pipeline auszuführen. Überprüfen Sie anhand des Ausführungsverlaufs, der Build-Logs und der Ausgabevariablen, ob die Build-Befehle ausgeführt wurden.

**So zeigen Sie Aktionsprotokolle und Ausgabevariablen an**

1. Nachdem die Pipeline erfolgreich ausgeführt wurde, können Sie die Protokolle und die Ausgabe für die Aktion anzeigen.

1. Um die Ausgabevariablen für die Aktion anzuzeigen, wählen Sie **Verlauf** und dann **Zeitleiste** aus. 

   Zeigen Sie die Ausgabevariable an, die der Aktion hinzugefügt wurde. Die Ausgabe für die Aktion Befehle zeigt die Ausgabevariable, die in die Aktionsregion aufgelöst wurde.  
![\[Die Ausgabe für die Aktion „Befehle“ zeigt die Ausgabevariable, aufgelöst in die Aktionsregion\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/commands-output-variable.png)

1. Um die Protokolle für die Aktion **anzuzeigen, wählen Sie Details zur** erfolgreichen Befehlsaktion anzeigen aus. Zeigen Sie die Protokolle für die Aktion „Befehle“ an.  
![\[Beispielprotokolle für die Aktion „Befehle“\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/commands-output-logs.png)