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.
Führen Sie das Beispiel „Bitbucket-Pull-Request und Webhook-Filter“ aus für CodeBuild
AWS CodeBuild unterstützt Webhooks, wenn das Quell-Repository Bitbucket ist. Das bedeutet, dass bei einem CodeBuild Build-Projekt, dessen Quellcode in einem Bitbucket-Repository gespeichert ist, Webhooks verwendet werden können, um den Quellcode jedes Mal neu zu erstellen, wenn eine Codeänderung in das Repository übertragen wird. Weitere Informationen finden Sie unter Bitbucket-Webhook-Ereignisse.
Dieses Beispiel zeigt, wie Sie eine Pull-Anfrage mit einem Bitbucket-Repository erstellen. Es zeigt dir auch, wie du einen Bitbucket-Webhook als Trigger verwendest, um einen Build eines Projekts CodeBuild zu erstellen.
Anmerkung
Bei der Verwendung von Webhooks ist es möglich, dass ein Benutzer einen unerwarteten Build auslöst. Informationen zur Minderung dieses Risikos finden Sie unter. Bewährte Methoden für die Verwendung von Webhooks
Themen
Voraussetzungen
Um dieses Beispiel auszuführen, musst du dein AWS CodeBuild Projekt mit deinem Bitbucket-Konto verbinden.
Anmerkung
CodeBuild hat seine Berechtigungen mit Bitbucket aktualisiert. Wenn du dein Projekt zuvor mit Bitbucket verbunden hast und jetzt ein Bitbucket-Verbindungsfehler angezeigt wird, musst du die Verbindung erneut herstellen, um die CodeBuild Erlaubnis zur Verwaltung deiner Webhooks zu erteilen.
Schritt 1: Erstelle ein Build-Projekt mit Bitbucket und aktiviere Webhooks
In den folgenden Schritten wird beschrieben, wie du ein AWS CodeBuild Projekt mit Bitbucket als Quell-Repository erstellst und Webhooks aktivierst.
Wenn eine CodeBuild Informationsseite angezeigt wird, wählen Sie Build-Projekt erstellen. Erweitern Sie andernfalls im Navigationsbereich Build, wählen Sie Build projects und dann Create build project aus.
-
Wählen Sie Create build project (Build-Projekt erstellen) aus.
-
In Project configuration (Projektkonfiguration):
- Project name
-
Geben Sie einen Namen für dieses Build-Projekt ein. Die Namen der Build-Projekte müssen für jedes AWS Konto eindeutig sein. Sie können auch eine optionale Beschreibung des Build-Projekts hinzufügen, damit andere Benutzer verstehen, wofür dieses Projekt verwendet wird.
-
In Source (Quelle):
- Quellanbieter
-
Wähle Bitbucket. Folge den Anweisungen, um dich mit Bitbucket zu verbinden (oder erneut zu verbinden) und wähle dann Autorisieren.
- Repository
-
Wähle in meinem Bitbucket-Konto Repository aus.
Falls du dich noch nicht mit deinem Bitbucket-Konto verbunden hast, gib deinen Bitbucket-Nutzernamen und dein App-Passwort ein und wähle Bitbucket-Anmeldeinformationen speichern aus.
- Bitbucket-Repository
-
Geben Sie das URL für Ihr Bitbucket-Repository ein.
-
Wählen Sie unter Webhook-Ereignisse der Primärquelle Folgendes aus.
Anmerkung
Der Abschnitt „Primäre Webhook-Ereignisse“ ist nur sichtbar, wenn du im vorherigen Schritt Repository in meinem Bitbucket-Konto ausgewählt hast.
-
Wählen Sie beim Erstellen Ihres Projekts Rebuild every time a code change is pushed to this repository (Erneut erstellen, wenn eine Codeänderung an dieses Repository übergeben wird) aus.
-
Wählen Sie unter Event type (Ereignistyp) eines oder mehrere Ereignisse aus.
-
Wenn Sie Fälle filtern möchten, in denen ein Ereignis einen Build auslöst, fügen Sie unter Start a build under these conditions (Unter diesen Bedingungen Build starten) einen oder mehrere optionale Filter hinzu.
-
Wenn Sie Fälle filtern möchten, in denen kein Ereignis ausgelöst wird, fügen Sie unter Don't start a build under these conditions (Unter diesen Bedingungen keinen Build starten) einen oder mehrere optionale Filter hinzu.
-
Wähle Filtergruppe hinzufügen, um bei Bedarf eine weitere Filtergruppe hinzuzufügen.
Weitere Informationen zu Bitbucket-Webhook-Ereignistypen und Filtern findest du unter. Bitbucket-Webhook-Ereignisse
-
-
In Environment (Umgebung):
- Bild der Umgebung
-
Wählen Sie eine der folgenden Optionen aus:
- Um ein Docker-Image zu verwenden, das verwaltet wird von AWS CodeBuild:
-
Wählen Sie Verwaltetes Image und wählen Sie dann Betriebssystem, Runtime (s), Image und Image-Version aus. Treffen Sie eine Auswahl unter Environment type (Umgebungstyp), sofern verfügbar.
- Um ein anderes Docker-Image zu verwenden:
-
Wählen Sie Benutzerdefiniertes Bild. Wählen Sie als Umgebungstyp Linux ARMGPU, Linux oder Windows aus. Wenn Sie Andere Registrierung wählenURL, geben Sie für Externe Registrierung den Namen und das Tag des Docker-Images in Docker Hub ein. Verwenden Sie dabei das Format.
docker repository/docker image name - Um ein privates Docker-Image zu verwenden:
-
Wählen Sie Benutzerdefiniertes Bild. Wählen Sie als Umgebungstyp Linux ARMGPU, Linux oder Windows aus. Wählen Sie für Image-Registrierung die ARN Option Andere Registrierung aus und geben Sie dann die Anmeldeinformationen für Ihr privates Docker-Image ein. Die Anmeldeinformationen müssen von Secrets Manager erstellt werden. Weitere Informationen finden Sie unter Was ist AWS Secrets Manager? im AWS Secrets Manager Benutzerhandbuch.
- Rolle im Dienst
-
Wählen Sie eine der folgenden Optionen aus:
-
Wenn Sie keine CodeBuild Servicerolle haben, wählen Sie Neue Servicerolle. Geben Sie im Feld Rollenname einen Namen für die neue Rolle ein.
-
Wenn Sie eine CodeBuild Servicerolle haben, wählen Sie Bestehende Servicerolle aus. Wählen Sie unter Rolle ARN die Servicerolle aus.
Anmerkung
Wenn Sie die Konsole verwenden, um ein Build-Projekt zu erstellen oder zu aktualisieren, können Sie gleichzeitig eine CodeBuild Servicerolle erstellen. In der Standardeinstellung funktioniert diese Rolle ausschließlich mit diesem Projekt. Wenn Sie die Konsole verwenden, um die Servicerolle mit einem anderen Build-Projekt zu verknüpfen, wird die Rolle so aktualisiert, dass sie mit dem anderen Build-Projekt funktioniert. Eine Servicerolle kann in bis zu zehn Build-Projekten verwendet werden.
-
Führen Sie in Buildspec einen der folgenden Schritte aus:
-
Wählen Sie Buildspec-Datei verwenden, um die Datei buildspec.yml im Quellcode-Stammverzeichnis zu verwenden.
-
Wählen Sie Build-Befehle einfügen, um die Konsole zum Einfügen von Build-Befehlen zu verwenden.
Weitere Informationen hierzu finden Sie unter Build-Spezifikationsreferenz.
-
-
In Artifacts (Artefakte):
- Typ
-
Wählen Sie eine der folgenden Optionen aus:
-
Wenn keine Build-Ausgabeartefakte erstellt werden sollen, klicken Sie auf die Option No artifacts (Keine Artefakte).
-
Um die Build-Ausgabe in einem S3-Bucket zu speichern, wählen Sie Amazon S3 und gehen Sie dann wie folgt vor:
-
Wenn Sie Ihren Projektnamen für die ZIP Build-Ausgabedatei oder den Ordner verwenden möchten, lassen Sie Name leer. Geben Sie andernfalls den Namen ein. Standardmäßig ist der Artefaktname der Projektname. Wenn Sie einen anderen Namen verwenden möchten, geben Sie diesen in das Feld für den Artefaktnamen ein. Wenn Sie eine ZIP Datei ausgeben möchten, geben Sie die ZIP-Erweiterung an.
-
Wählen Sie für Bucket name den Namen des Ausgabe-Buckets aus.
-
Wenn Sie zuvor in diesem Verfahren Build-Befehle einfügen ausgewählt haben, geben Sie für Ausgabedateien die Speicherorte der Dateien aus dem Build ein, die Sie in die ZIP Build-Ausgabedatei oder den Build-Ausgabeordner einfügen möchten. Bei mehreren Speicherorten trennen Sie die einzelnen Speicherorte durch ein Komma, (wie z. B.
appspec.yml, target/my-app.jar). Weitere Informationen finden Sie in der Beschreibung vonfilesin Syntax der Build-Spezifikation.
-
-
- Zusätzliche Konfiguration
-
Erweitern Sie Additional configuration (Zusätzliche Einstellungen) und legen Sie die entsprechenden Optionen fest.
-
Wählen Sie Create build project (Build-Projekt erstellen) aus. Klicken Sie auf der Seite Review (Überprüfen) auf Start build (Build starten), um den Build auszuführen.
Schritt 2: Einen Build mit einem Bitbucket-Webhook auslösen
Bei einem Projekt, das Bitbucket-Webhooks verwendet, AWS CodeBuild wird ein Build erstellt, wenn das Bitbucket-Repository eine Änderung in deinem Quellcode feststellt.
-
Wählen Sie im Navigationsbereich Build projects (Build-Projekte) und dann ein Projekt aus, das mit einem Bitbucket-Repository mit Webhooks verknüpft ist. Informationen zum Erstellen eines Bitbucket-Webhook-Projekts findest du unter. Schritt 1: Erstelle ein Build-Projekt mit Bitbucket und aktiviere Webhooks
-
Nehmen Sie einige Änderungen am Code in Ihrem Bitbucket-Repository des Projekts vor.
-
Erstellen Sie eine Pull-Anfrage in Ihrem Bitbucket-Repository. Weitere Informationen finden Sie auf der Seite zum Durchführen einer Pull-Anfrage
. -
Wählen Sie auf der Seite über Bitbucket-Webhooks View request (Anfrage anzeigen) aus, um eine Liste der jüngsten Ereignisse anzuzeigen.
-
Wähle Details anzeigen, um Details zu der Antwort von zu sehen. CodeBuild Er kann wie folgt aussehen:
"response":"Webhook received and build started: https://us-east-1.console.aws.amazon.com/codebuild/home..." "statusCode":200 -
Navigieren Sie zur Seite über Bitbucket Pull-Anfragen, um den Build-Status anzuzeigen.
