Wählen Sie Ihre Cookie-Einstellungen aus

Wir verwenden essentielle Cookies und ähnliche Tools, die für die Bereitstellung unserer Website und Services erforderlich sind. Wir verwenden Performance-Cookies, um anonyme Statistiken zu sammeln, damit wir verstehen können, wie Kunden unsere Website nutzen, und Verbesserungen vornehmen können. Essentielle Cookies können nicht deaktiviert werden, aber Sie können auf „Anpassen“ oder „Ablehnen“ klicken, um Performance-Cookies abzulehnen.

Wenn Sie damit einverstanden sind, verwenden AWS und zugelassene Drittanbieter auch Cookies, um nützliche Features der Website bereitzustellen, Ihre Präferenzen zu speichern und relevante Inhalte, einschließlich relevanter Werbung, anzuzeigen. Um alle nicht notwendigen Cookies zu akzeptieren oder abzulehnen, klicken Sie auf „Akzeptieren“ oder „Ablehnen“. Um detailliertere Entscheidungen zu treffen, klicken Sie auf „Anpassen“.

Beispiel für Benachrichtigungen erstellen für CodeBuild

Fokusmodus

Auf dieser Seite

Beispiel für Benachrichtigungen erstellen für CodeBuild - AWS CodeBuild

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.

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.

Amazon CloudWatch Events bietet integrierte Unterstützung für AWS CodeBuild. CloudWatch Events ist ein Stream von Systemereignissen, die Änderungen an Ihren AWS Ressourcen beschreiben. Mit CloudWatch Ereignissen schreiben Sie deklarative Regeln, um interessante Ereignisse mit zu ergreifenden automatisierten Aktionen zu verknüpfen. In diesem Beispiel werden Amazon CloudWatch Events und Amazon Simple Notification Service (AmazonSNS) verwendet, um Build-Benachrichtigungen an Abonnenten zu senden, wenn Builds erfolgreich sind, fehlschlagen, von einer Buildphase zur nächsten wechseln oder wenn eine Kombination dieser Ereignisse vorliegt.

Wichtig

Die Ausführung dieses Beispiels kann dazu führen, dass Ihr AWS Konto belastet wird. Dazu gehören mögliche Gebühren für CodeBuild und für AWS Ressourcen und Aktionen im Zusammenhang mit Amazon CloudWatch und AmazonSNS. Weitere Informationen finden Sie unter CodeBuild Preise, CloudWatchAmazon-Preise und SNSAmazon-Preise.

Führen Sie das Beispiel für Build-Benachrichtigungen aus

Gehen Sie wie folgt vor, um das Beispiel für Buildbenachrichtigungen auszuführen.

So führen Sie das Beispiel aus
  1. Wenn Sie bei Amazon bereits ein Thema eingerichtet und abonniert habenSNS, das Sie für dieses Beispiel verwenden möchten, fahren Sie mit Schritt 4 fort. Andernfalls, wenn Sie einen IAM Benutzer anstelle eines AWS Root-Kontos oder eines Administrator-Benutzers für die Arbeit mit Amazon verwendenSNS, fügen Sie die folgende Aussage hinzu (zwischen ### BEGIN ADDING STATEMENT HERE ### and ### END ADDING STATEMENT HERE ###) für den Benutzer (oder die IAM Gruppe, der der Benutzer zugeordnet ist). Die Verwendung eines AWS Root-Kontos wird nicht empfohlen. Diese Erklärung ermöglicht das Anzeigen, Erstellen, Abonnieren und Testen des Versands von Benachrichtigungen zu Themen in AmazonSNS. Auslassungspunkte (...) werden zur Abkürzung verwendet und weisen auf die Stellen hin, an denen die Anweisung hinzugefügt wird. Entfernen Sie keine Anweisungen und geben Sie die Auslassungspunkte nicht in die vorhandene Richtlinie ein.

    { "Statement": [ ### BEGIN ADDING STATEMENT HERE ### { "Action": [ "sns:CreateTopic", "sns:GetTopicAttributes", "sns:List*", "sns:Publish", "sns:SetTopicAttributes", "sns:Subscribe" ], "Resource": "*", "Effect": "Allow" }, ### END ADDING STATEMENT HERE ### ... ], "Version": "2012-10-17" }
    Anmerkung

    Die IAM Entität, die diese Richtlinie ändert, muss über die Erlaubnis verfügen, Richtlinien IAM zu ändern.

    Weitere Informationen finden Sie unter Bearbeiten von kundenverwalteten Richtlinien oder im Abschnitt „So bearbeiten oder löschen Sie eine Inline-Richtlinie für eine Gruppe, einen Benutzer oder eine Rolle“ unter Arbeiten mit Inline-Richtlinien (Konsole) im IAMBenutzerhandbuch.

  2. Erstelle oder identifiziere ein Thema in AmazonSNS. AWS CodeBuild verwendet CloudWatch Events, um Build-Benachrichtigungen zu diesem Thema über Amazon zu sendenSNS.

    Erstellen Sie ein Thema wie folgt:

    1. Öffnen Sie die SNS Amazon-Konsole unter https://console.aws.amazon.com/sns.

    2. Wählen Sie Thema erstellen aus.

    3. Geben Sie unter Create new topic (Neues Thema erstellen) für Topic name (Themenname) einen Namen für das Thema ein (z. B. CodeBuildDemoTopic). (Wenn Sie einen anderen Namen verwenden, muss dieser im gesamten Beispiel verwendet werden.)

    4. Wählen Sie Thema erstellen aus.

    5. Kopieren Sie auf der CodeBuildDemoTopic Seite mit den Themendetails: den Wert für das Thema ARN. Sie benötigen diesen Wert im nächsten Schritt.

      Der ARN Wert Thema.

    Weitere Informationen finden Sie unter Thema erstellen im Amazon SNS Developer Guide.

  3. Abonnieren Sie das Thema für einen oder mehrere Empfänger, um E-Mail-Benachrichtigungen zu empfangen.

    So abonnieren Sie ein Thema für einen Empfänger:

    1. Wählen Sie bei geöffneter SNS Amazon-Konsole aus dem vorherigen Schritt im Navigationsbereich Abonnements und anschließend Abonnement erstellen aus.

    2. Fügen Sie unter Abonnement erstellen unter Thema das Thema einARN, das ARN Sie aus dem vorherigen Schritt kopiert haben.

    3. Wählen Sie unter Protocol (Protokoll) die Option Email (E-Mail) aus.

    4. Geben Sie für Endpoint (Endpunkt) die vollständige E-Mail-Adresse des Empfängers ein.

      Die Abonnementkonfiguration.

    5. Klicken Sie auf Create subscription (Abonnement erstellen).

    6. Amazon SNS sendet eine Bestätigungs-E-Mail für das Abonnement an den Empfänger. Um Benachrichtigungen zu erhalten, muss der Empfänger den Link Confirm subscription in der Bestätigungs-E-Mail wählen. Nachdem der Empfänger auf den Link geklickt hat, SNS zeigt Amazon bei erfolgreichem Abonnement eine Bestätigungsnachricht im Webbrowser des Empfängers an.

    Weitere Informationen finden Sie unter Abonnieren eines Themas im Amazon SNS Developer Guide.

  4. Wenn Sie einen Benutzer anstelle eines AWS Root-Kontos oder eines Administrator-Benutzers für die Arbeit mit CloudWatch Events verwenden, fügen Sie die folgende Erklärung hinzu (zwischen ### BEGIN ADDING STATEMENT HERE ### and ### END ADDING STATEMENT HERE ###) dem Benutzer (oder der IAM Gruppe, der der Benutzer zugeordnet ist). Die Verwendung eines AWS Root-Kontos wird nicht empfohlen. Diese Anweisung wird verwendet, um dem Benutzer die Arbeit mit CloudWatch Ereignissen zu ermöglichen. Auslassungspunkte (...) werden zur Abkürzung verwendet und weisen auf die Stellen hin, an denen die Anweisung hinzugefügt wird. Entfernen Sie keine Anweisungen und geben Sie die Auslassungspunkte nicht in die vorhandene Richtlinie ein.

    { "Statement": [ ### BEGIN ADDING STATEMENT HERE ### { "Action": [ "events:*", "iam:PassRole" ], "Resource": "*", "Effect": "Allow" }, ### END ADDING STATEMENT HERE ### ... ], "Version": "2012-10-17" }
    Anmerkung

    Die IAM Entität, die diese Richtlinie ändert, muss berechtigt sein, Richtlinien IAM zu ändern.

    Weitere Informationen finden Sie unter Bearbeiten von kundenverwalteten Richtlinien oder im Abschnitt „So bearbeiten oder löschen Sie eine Inline-Richtlinie für eine Gruppe, einen Benutzer oder eine Rolle“ unter Arbeiten mit Inline-Richtlinien (Konsole) im IAMBenutzerhandbuch.

  5. Erstellen Sie eine Regel unter CloudWatch Ereignisse. Öffnen Sie dazu die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch.

  6. Wählen Sie im Navigationsbereich unter Events Rules aus und anschließend Create rule.

  7. Auf der Seite Step 1: Create rule page (Schritt 1: Regel erstellen), sollten bereits die Optionen Event Pattern (Ereignismuster) und Build event pattern to match events by service (Ereignismuster erstellen, um Ereignisse nach Service abzugleichen) ausgewählt sein.

  8. Wählen Sie für Servicename CodeBuild aus. Bei Event Type (Ereignistyp) sollte bereits All Events (Alle Ereignisse) ausgewählt sein.

  9. Der folgende Code sollte in Event Pattern Preview (Ereignismustervorschau) angezeigt werden:

    { "source": [ "aws.codebuild" ] }
  10. Wählen Sie die Option Edit (Bearbeiten) und ersetzen Sie den Code in Event Pattern Preview (Ereignismustervorschau) durch eines der beiden folgenden Regelmuster.

    Das erste Regelmuster löst für die in AWS CodeBuild angegebenen Build-Projekte ein Ereignis aus, sobald ein Build gestartet oder abgeschlossen wird.

    { "source": [ "aws.codebuild" ], "detail-type": [ "CodeBuild Build State Change" ], "detail": { "build-status": [ "IN_PROGRESS", "SUCCEEDED", "FAILED", "STOPPED" ], "project-name": [ "my-demo-project-1", "my-demo-project-2" ] } }

    Nehmen Sie in der vorhergehenden Regel die folgenden Code-Änderungen nach Bedarf vor.

    • Um ein Ereignis auszulösen, sobald ein Build beginnt oder abgeschlossen ist, lassen Sie entweder alle Werte wie im build-status Array gezeigt stehen oder entfernen Sie build-status das Array vollständig.

    • Um ein Ereignis nur dann auszulösen, wenn ein Build abgeschlossen ist, entfernen Sie IN_PROGRESS aus dem build-status Array.

    • Um ein Ereignis nur dann auszulösen, wenn ein Build startet, entfernen Sie alle Werte außer IN_PROGRESS aus dem build-status Array.

    • Um Ereignisse für alle Build-Projekte auszulösen, entfernen Sie das project-name Array vollständig.

    • Um Ereignisse nur für einzelne Build-Projekte auszulösen, geben Sie den Namen des jeweiligen Build-Projekts im Array project-name an.

    Dieses zweite Regelmuster löst ein Ereignis aus, sobald bei den in AWS CodeBuild angegebenen Build-Projekten ein Build von einer Build-Phase in eine andere wechselt.

    { "source": [ "aws.codebuild" ], "detail-type": [ "CodeBuild Build Phase Change" ], "detail": { "completed-phase": [ "SUBMITTED", "PROVISIONING", "DOWNLOAD_SOURCE", "INSTALL", "PRE_BUILD", "BUILD", "POST_BUILD", "UPLOAD_ARTIFACTS", "FINALIZING" ], "completed-phase-status": [ "TIMED_OUT", "STOPPED", "FAILED", "SUCCEEDED", "FAULT", "CLIENT_ERROR" ], "project-name": [ "my-demo-project-1", "my-demo-project-2" ] } }

    Nehmen Sie in der vorhergehenden Regel die folgenden Code-Änderungen nach Bedarf vor.

    • Um ein Ereignis für jeden Build-Phasenwechsel auszulösen (wodurch bis zu neun Benachrichtigungen für jeden Build gesendet werden können), lassen Sie entweder alle Werte, wie im completed-phase-Array gezeigt, stehen oder entfernen Sie das completed-phase-Array vollständig.

    • Um Ereignisse nur für einzelne Build-Phasenänderungen auszulösen, entfernen Sie den Namen jeder Build-Phase in dem completed-phase-Array, für das Sie kein Ereignis auslösen möchten.

    • Um ein Ereignis für jede Statusänderung einer Build-Phase auszulösen, lassen Sie entweder alle Werte, wie im completed-phase-status-Array gezeigt, stehen oder entfernen Sie das completed-phase-status-Array vollständig.

    • Um Ereignisse nur für einzelne Statusänderungen von Build-Phasen auszulösen, entfernen Sie den Namen des jeweiligen Status einer Build-Phase in dem completed-phase-status-Array, für das Sie kein Ereignis auslösen möchten.

    • Um Ereignisse für alle Build-Projekte auszulösen, entfernen Sie das project-name-Array.

    • Um Ereignisse für einzelne Build-Projekte auszulösen, geben Sie den Namen des jeweiligen Build-Projekts im project-name-Array an.

    Weitere Informationen zu Ereignismustern finden Sie unter Ereignismuster im EventBridge Amazon-Benutzerhandbuch.

    Weitere Informationen zum Filtern mit Ereignismustern finden Sie unter Inhaltsbasiertes Filtern mit Ereignismustern im EventBridge Amazon-Benutzerhandbuch.

    Anmerkung

    Wenn Sie Ereignisse sowohl für Build-Statusänderungen als auch für Build-Phasenänderungen auslösen möchten, müssen Sie zwei separate Regeln erstellen: eine für Build-Statusänderungen und eine für Build-Phasenänderungen. Wenn Sie versuchen, beide Regeln zu einer einzigen Regel zusammenzufassen, führt die kombinierte Regel ggf. zu unerwarteten Ergebnissen oder funktioniert ggf. gar nicht mehr.

    Wenn Sie mit dem Ersetzen des Codes fertig sind, wählen Sie Save (Speichern) aus.

  11. Wählen Sie für Targets die Option Add target aus.

  12. Wählen Sie in der Liste der Ziele das SNSThema aus.

  13. Als Topic wählen Sie das Thema, das Sie zuvor identifiziert oder erstellt haben.

  14. Erweitern Sie Configure input und wählen Sie dann Input Transformer aus.

  15. Geben Sie im Feld Input Path (Eingabepfad) einen der folgenden Eingabepfade ein.

    Geben Sie für eine Regel mit einem detail-type-Wert von CodeBuild Build State Change Folgendes ein.

    {"build-id":"$.detail.build-id","project-name":"$.detail.project-name","build-status":"$.detail.build-status"}

    Geben Sie für eine Regel mit einem detail-type-Wert von CodeBuild Build Phase Change Folgendes ein.

    {"build-id":"$.detail.build-id","project-name":"$.detail.project-name","completed-phase":"$.detail.completed-phase","completed-phase-status":"$.detail.completed-phase-status"}

    Weitere Informationen finden Sie unter Eingabeformat-Referenz für Build-Benachrichtigungen.

  16. Geben Sie im Feld Input Template (Eingabevorlage) eine der folgenden Eingabevorlagen ein.

    Geben Sie für eine Regel mit einem detail-type-Wert von CodeBuild Build State Change Folgendes ein.

    "Build '<build-id>' for build project '<project-name>' has reached the build status of '<build-status>'."

    Geben Sie für eine Regel mit einem detail-type-Wert von CodeBuild Build Phase Change Folgendes ein.

    "Build '<build-id>' for build project '<project-name>' has completed the build phase of '<completed-phase>' with a status of '<completed-phase-status>'."
  17. Wählen Sie Details konfigurieren.

  18. Geben Sie auf der Seite Step 2: Configure rule details (Schritt 2: Konfigurieren von Regeldetails) einen Namen ein und eine optionale Beschreibung ein. Lassen Sie unter Status die Option Enabled (Aktiviert) ausgewählt.

  19. Wählen Sie Regel erstellen aus.

  20. Erstellen Sie Build-Projekte, führen Sie die Builds aus und zeigen Sie Build-Informationen an.

  21. Bestätigen Sie, CodeBuild dass Build-Benachrichtigungen jetzt erfolgreich gesendet werden. Überprüfen Sie beispielsweise, ob sich die Build-Benachrichtigungs-E-Mails jetzt in Ihrem Posteingang befinden.

Um das Verhalten einer Regel zu ändern, wählen Sie in der CloudWatch Konsole die Regel aus, die Sie ändern möchten, klicken Sie auf Aktionen und dann auf Bearbeiten. Nehmen Sie Änderungen an der Regel vor, wählen Sie Configure details (Details konfigurieren), und klicken Sie dann auf Update rule (Regel aktualisieren).

Um eine Regel nicht mehr zum Senden von Build-Benachrichtigungen zu verwenden, wählen Sie in der CloudWatch Konsole die Regel aus, die Sie nicht mehr verwenden möchten, wählen Sie Aktionen und dann Deaktivieren aus.

Um eine Regel vollständig zu löschen, wählen Sie in der CloudWatch Konsole die Regel aus, die Sie löschen möchten, klicken Sie auf Aktionen und dann auf Löschen.

DatenschutzNutzungsbedingungen für die WebsiteCookie-Einstellungen
© 2025, Amazon Web Services, Inc. oder Tochtergesellschaften. Alle Rechte vorbehalten.