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: Filtere nach Branch-Namen für Pull-Requests, um deine Pipeline zu starten (Typ V2)
In diesem Tutorial erstellen Sie eine Pipeline, die eine Verbindung zu Ihrem GitHub .com-Repository herstellt, wo die Quellaktion so konfiguriert ist, dass Ihre Pipeline mit einer Trigger-Konfiguration gestartet wird, die nach Pull-Requests filtert. Wenn ein bestimmtes Pull-Request-Ereignis für einen bestimmten Branch eintritt, wird Ihre Pipeline gestartet. Dieses Beispiel zeigt Ihnen, wie Sie eine Pipeline erstellen, die das Filtern nach Zweignamen ermöglicht. Weitere Informationen zum Arbeiten mit Triggern finden Sie unter[Filter für Push- und Pull-Request-Ereignistypen hinzufügen (CLI)](pipelines-filter.md#pipelines-filter-cli). Weitere Informationen zum Filtern mit Regex-Mustern im Glob-Format finden Sie unter. [Arbeiten mit Glob-Mustern in der Syntax](syntax-glob.md)
**Wichtig**
Im Rahmen der Erstellung einer Pipeline wird ein vom Kunden bereitgestellter S3-Artefakt-Bucket von for Artifacts verwendet. CodePipeline (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.
In diesem Tutorial wird über den `CodeStarSourceConnection` Aktionstyp eine Verbindung zu GitHub .com hergestellt.
**Topics**
+ [Voraussetzungen](#tutorials-github-featurebranches-prereq)
+ [Schritt 1: Erstellen Sie eine Pipeline, die bei einem Pull-Request für bestimmte Branches gestartet wird](#tutorials-github-featurebranches-pipeline)
+ [Schritt 2: Erstellen Sie eine Pull-Anfrage auf GitHub .com und führen Sie sie zusammen, um Ihre Pipeline-Ausführungen zu starten](#tutorials-github-featurebranches-pullrequest)
## Voraussetzungen
Sie benötigen Folgendes, um starten zu können:
+ Erstellen Sie ein GitHub .com-Repository mit Ihrem GitHub .com-Konto.
+ Halten Sie Ihre GitHub Anmeldedaten bereit. Wenn Sie den verwenden AWS-Managementkonsole , um eine Verbindung herzustellen, werden Sie aufgefordert, sich mit Ihren GitHub Anmeldeinformationen anzumelden.
## Schritt 1: Erstellen Sie eine Pipeline, die bei einem Pull-Request für bestimmte Branches gestartet wird
In diesem Abschnitt erstellen Sie eine Pipeline mit den folgenden Aktionen:
+ Eine Quellphase mit einer Verbindung zu Ihrem GitHub .com-Repository und einer Aktion.
+ Eine Build-Phase mit einer AWS CodeBuild Build-Aktion.
**So erstellen Sie mit dem Assistenten eine Pipeline**
1. Melden Sie sich bei der CodePipeline Konsole an unter [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Wählen Sie auf der Seite **Welcome (Willkommen)** die Option **Getting started (Erste Schritte)** 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**MyFilterBranchesPipeline**.
1. Behalten Sie im Feld **Pipeline-Typ** die Standardauswahl **V2** bei. Pipeline-Typen unterscheiden sich in ihren Eigenschaften und im Preis. Weitere Informationen finden Sie unter [Arten von Pipelines](pipeline-types.md).
1. Wählen Sie unter **Service role (Servicerolle)** die Option **New service role (Neue Servicerolle)**.
**Anmerkung**
Wenn Sie stattdessen Ihre bestehende CodePipeline Servicerolle verwenden möchten, stellen Sie sicher, dass Sie die `codeconnections:UseConnection` IAM-Berechtigung zu Ihrer Servicerollenrichtlinie hinzugefügt haben. Anweisungen für die CodePipeline Servicerolle finden [Sie unter Hinzufügen von Berechtigungen zur CodePipeline Servicerolle](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).
1. Lassen Sie die Standardwerte bei **Erweiterte Einstellungen** unverändert. Wählen Sie unter **Artifact store (Artefaktspeicher)** die Option **Default location (Standardstandort)** aus, um den Standard-Artefakt-Speicherort für die Pipeline in der entsprechenden Region zu verwenden, beispielsweise mit dem Amazon S3-Artefakt-Bucket als Standard.
**Anmerkung**
Dabei handelt es sich nicht um den Quell-Bucket für Ihren Quellcode, sondern um den Artefaktspeicher für Ihre Pipeline. Für jede Pipeline benötigen Sie einen separaten Artefaktspeicher, z. B. einen S3 Bucket.
Wählen Sie **Next (Weiter)**.
1. **Fügen Sie auf der Seite Schritt 3: Quellstufe** hinzufügen eine Quellstufe 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 **Triggertyp** die Option **Filter angeben** aus.
Wählen Sie unter **Ereignistyp** die Option **Pull-Anfrage** aus. Wählen Sie unter Pull Request alle Ereignisse aus, sodass das Ereignis für erstellte, aktualisierte oder geschlossene Pull Requests eintritt.
Geben Sie unter **Branches** in das Feld **Include** den Wert ein`main*`.
![\[Das Bild zeigt die Option Branches einbeziehen, die mit dem Wert main* für einen Trigger mit dem Ereignistyp Pull-Request ausgewählt wurde\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/pullreq-example-triggers-edit.png)
**Wichtig**
Pipelines, die mit diesem Triggertyp beginnen, werden für WebhookV2-Ereignisse konfiguriert und verwenden nicht das Webhook-Ereignis (Änderungserkennung bei allen Push-Ereignissen), um die Pipeline zu starten.
Wählen Sie **Weiter** aus.
1. **Wählen Sie in **Schritt 4: Buildphase hinzufügen unter Build** Provider die Option aus. **AWS CodeBuild**** Belassen Sie unter **Region** als Standardeinstellung die Pipeline-Region. Wählen oder erstellen Sie das Build-Projekt wie unter beschrieben[Tutorial: Verwende Git-Tags, um deine Pipeline zu starten](tutorials-github-tags.md). Diese Aktion wird in diesem Tutorial nur als zweite Phase verwendet, die zum Erstellen Ihrer Pipeline erforderlich ist.
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 auf der Seite **Schritt 6: Bereitstellungsphase hinzufügen** die Option **Bereitstellungsphase überspringen** aus und akzeptieren Sie dann die Warnmeldung, indem Sie erneut auf **Überspringen** klicken. Wählen Sie **Weiter** aus.
1. Wählen **Sie auf Schritt 7: Überprüfen** die Option **Pipeline erstellen** aus.
## Schritt 2: Erstellen Sie eine Pull-Anfrage auf GitHub .com und führen Sie sie zusammen, um Ihre Pipeline-Ausführungen zu starten
In diesem Abschnitt erstellen Sie einen Pull-Request und führen ihn zusammen. Dadurch wird Ihre Pipeline mit einer Ausführung für den geöffneten Pull-Request und einer Ausführung für den geschlossenen Pull-Request gestartet.
**Um eine Pull-Anfrage zu erstellen und Ihre Pipeline zu starten**
1. Erstellen Sie in GitHub .com eine Pull-Anfrage, indem Sie eine Änderung an der Datei README.md in einem Feature-Branch vornehmen und eine Pull-Anfrage an den Branch senden. `main` Bestätigen Sie die Änderung mit einer Nachricht wie. `Update README.md for PR`
1. Die Pipeline beginnt mit der Quellrevision, die die **Quellnachricht** für den Pull-Request als **Update README.md** for PR anzeigt.
![\[Das Bild zeigt die Quellnachricht für die Pull-Anfrage mit dem folgenden Text: Update README.md for PR\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/pullreq-example.png)
1. Wählen Sie **History (Verlauf)** aus. Sehen Sie sich im Verlauf der Pipeline-Ausführung die Pull-Request-Statusereignisse CREATED und MERGED an, die die Pipeline-Ausführungen gestartet haben.
![\[Bild mit dem Pipeline-Ausführungsverlauf, in dem die Pull-Request-Statusereignisse CREATED und MERGED angezeigt werden, die die Pipeline-Ausführungen gestartet haben\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/pullreq-example-history.png)