Tutorial: Filtere nach Branch-Namen für Pull-Requests, um deine Pipeline zu starten (Typ V2) - AWS CodePipeline

View a markdown version of this page

Tutorial: Filtere nach Branch-Namen für Pull-Requests, um deine Pipeline zu starten (Typ V2) - AWS CodePipeline
VoraussetzungenSchritt 1: Erstellen Sie eine Pipeline, um mit einem Pull-Request für bestimmte Branches zu beginnenSchritt 2: Erstelle einen Pull-Request und füge ihn zusammen GitHub.com , um mit der Ausführung deiner Pipeline zu beginnen

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 erstellst du eine Pipeline, die eine Verbindung zu deinem GitHub.com Repository herstellt. Dort ist die Quellaktion so konfiguriert, dass deine Pipeline mit einer Triggerkonfiguration gestartet wird, die nach Pull-Requests filtert. Wenn ein bestimmtes Pull-Request-Ereignis für einen bestimmten Branch eintritt, startet deine Pipeline. Dieses Beispiel zeigt Ihnen, wie Sie eine Pipeline erstellen, die das Filtern nach Branchnamen ermöglicht. Weitere Informationen zum Arbeiten mit Triggern finden Sie unterFügen Sie Filter für Push- und Pull-Request-Ereignistypen (CLI) hinzu. Weitere Hinweise zum Filtern mit Regex-Mustern im Glob-Format finden Sie unter. Arbeiten mit Glob-Mustern in der Syntax

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 als dem Konto für Ihre Pipeline befindet, stellen Sie sicher, dass der S3-Artefakt-Bucket dem Konto gehört AWS-Konten , das sicher und zuverlässig ist.

In diesem Tutorial wird GitHub.com über den CodeStarSourceConnection Aktionstyp eine Verbindung hergestellt.

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 Anmeldeinformationen bereit. Wenn Sie das verwenden AWS-Managementkonsole , um eine Verbindung herzustellen, werden Sie aufgefordert, sich mit Ihren GitHub Anmeldeinformationen anzumelden.

Schritt 1: Erstellen Sie eine Pipeline, um mit einem Pull-Request für bestimmte Branches zu beginnen

In diesem Abschnitt erstellen Sie eine Pipeline mit den folgenden Aktionen:

  • Eine Quellstufe mit einer Verbindung zu deinem GitHub.com Repository und deiner 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 unter an https://console.aws.amazon.com/codepipeline/.

  2. 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).

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

  4. Geben Sie auf Schritt 2: Wählen Sie die Pipeline-Einstellungen aus und geben Sie im Feld Pipeline-Name den Wert einMyFilterBranchesPipeline.

  5. Behalten Sie unter Pipeline-Typ die Standardauswahl bei V2. Die Pipeline-Typen unterscheiden sich in ihren Eigenschaften und ihrem Preis. Weitere Informationen finden Sie unter Pipeline-Typen.

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

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

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

    2. 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 unterGitHub Verbindungen.

    3. Wählen Sie im Feld Repository name (Repositoryname) den Namen Ihres GitHub.com-Repositorys aus.

    4. Wählen Sie unter Triggertyp die Option Filter angeben aus.

      Wählen Sie unter Ereignistyp die Option Pull-Request aus. Wähle alle Ereignisse unter Pull Request aus, sodass das Ereignis bei erstellten, aktualisierten oder geschlossenen Pull Requests eintritt.

      Geben Sie unter Branches in das Feld Include einmain*.

      Das Bild zeigt die Option „Zweige einbeziehen“, die mit dem Wert von main* für einen Trigger mit dem Ereignistyp Pull-Request ausgewählt wurde
      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.

  9. Wählen Sie in Schritt 4: Build-Phase hinzufügen unter Build-Anbieter die Option. AWS CodeBuild Belassen Sie unter Region als Standardeinstellung die Pipeline-Region. Wählen oder erstellen Sie das Build-Projekt wie unter beschriebenTutorial: Verwende Git-Tags, um deine Pipeline zu starten. Diese Aktion wird in diesem Tutorial nur als zweite Phase verwendet, die zum Erstellen Ihrer Pipeline erforderlich ist.

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

    Wählen Sie Weiter aus.

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

  12. Wählen Sie auf Schritt 7: Überprüfen die Option Pipeline erstellen aus.

Schritt 2: Erstelle einen Pull-Request und füge ihn zusammen GitHub.com , um mit der Ausführung deiner Pipeline zu beginnen

In diesem Abschnitt erstellst du einen Pull Request und führst ihn zusammen. Dadurch wird deine Pipeline mit einer Ausführung für den geöffneten Pull Request und einer Ausführung für den geschlossenen Pull Request gestartet.

Um einen Pull Request zu erstellen und deine Pipeline zu starten

  1. Erstelle in einen Pull Request GitHub.com, indem du eine Änderung an einem Feature-Branch vornimmst und einen Pull Request an den main Branch sendest. README.md Bestätigen Sie die Änderung mit einer Nachricht wieUpdate README.md for PR.

  2. Die Pipeline beginnt mit der Quellrevision und zeigt die Quellnachricht für den Pull-Request als Update README.md for PR an.

    Das Bild zeigt die Quellnachricht für den Pull-Request mit dem folgenden Text: Update README.md for PR

  3. Wählen Sie History (Verlauf) aus. Sehen Sie sich im Verlauf der Pipeline-Ausführung die Statusereignisse CREATED und MERGED für Pull-Requests an, mit denen die Pipeline-Ausführungen gestartet wurden.

    Bild, das den Pipeline-Ausführungsverlauf zeigt und die Pull-Request-Statusereignisse CREATED und MERGED zeigt, mit denen die Pipeline-Ausführungen gestartet wurden