Tutorial: Richten Sie eine CloudWatch Event-Regel ein, um E-Mail-Benachrichtigungen über Änderungen des Pipeline-Status zu erhalten

Erstellen oder identifizieren Sie ein Thema in Amazon SNS. CodePipeline verwendet CloudWatch Ereignisse, um Benachrichtigungen zu diesem Thema über Amazon SNS zu senden. Erstellen Sie ein Thema wie folgt:

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

2. Wählen Sie Thema erstellen aus.

3. Geben Sie in das Dialogfeld Create new topic (Neues Thema erstellen) für Topic name (Themennamen) einen Namen für das Thema ein (z. B. PipelineNotificationTopic).

   

4. Wählen Sie Thema erstellen aus.

   Weitere Informationen finden Sie im Amazon SNS-Entwicklerhandbuch unter Thema erstellen.

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 in der Amazon SNS-Konsole in der Themenliste das Kontrollkästchen neben Ihrem neuen Thema aus. Wählen Sie Actions, Subscribe to topic aus.

2. Vergewissern Sie sich, dass im Dialogfeld Create subscription unter Topic ARN ein ARN angezeigt wird.

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

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

5. Wählen Sie Create Subscription.

6. Amazon SNS sendet eine Abonnement-Bestätigungs-E-Mail an den Empfänger. Um E-Mail-Benachrichtigungen zu empfangen, muss der Empfänger den Link Confirm subscription in dieser E-Mail aufrufen. Nachdem der Empfänger auf den Link geklickt hat, zeigt Amazon SNS bei erfolgreichem Abonnement eine Bestätigungsnachricht im Webbrowser des Empfängers an.

   Weitere Informationen finden Sie unter Abonnieren eines Themas im Amazon SNS-Entwicklerhandbuch.

1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie im Navigationsbereich die Option Events.

3. Wählen Sie Regel erstellen aus. Wählen Sie unter Event source (Ereignisquelle) die Option AWS CodePipeline aus. Wählen Sie für Event Type die Option Pipeline Execution State Change aus.

4. Wählen Sie Specific state(s) (Spezifische(r) Status) aus und dann die Option FAILED.

5. Wählen Sie Edit aus, um den JSON-Editor für den Bereich Event Pattern Preview zu öffnen. Fügen Sie den pipeline-Parameter mit dem Namen Ihrer Pipeline wie im folgenden Beispiel für eine Pipeline mit dem Namen "myPipeline" gezeigt hinzu.

   Sie können das Ereignismuster hier kopieren und in die Konsole einfügen:

   {
     "source": [
       "aws.codepipeline"
     ],
     "detail-type": [
       "CodePipeline Pipeline Execution State Change"
     ],
     "detail": {
       "state": [
         "FAILED"
       ],
       "pipeline": [
         "myPipeline"
       ]
     }
   }

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

7. Wählen Sie in der Liste der Ziele SNS topic aus. Geben Sie für Topic das erstellte Thema an.

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

9. Geben Sie im Feld Input Path die folgenden Schlüssel-Wert-Paare ein.

   { "pipeline" : "$.detail.pipeline" }

   Geben Sie im Feld Input Template Folgendes ein:

   "The Pipeline <pipeline> has failed."

10. Wählen Sie Details konfigurieren.

11. Geben Sie auf der Seite Configure rule details einen Namen und optional eine Beschreibung ein. Lassen Sie für State das Kontrollkästchen Enabled aktiviert.

12. Wählen Sie Regel erstellen aus.

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

14. Um das Verhalten einer Regel zu ändern, wählen Sie in der CloudWatch Konsole die Regel aus und klicken Sie dann auf Aktionen, Bearbeiten. Bearbeiten Sie die Regel, wählen Sie Configure details und anschließend Update rule aus.

    Um die Verwendung einer Regel zum Senden von Build-Benachrichtigungen zu beenden, wählen Sie in der CloudWatch Konsole die Regel aus und klicken Sie dann auf Aktionen > Deaktivieren.

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