Erstellen einer Benachrichtigungsregel für ein Repository

Sie können Benachrichtigungsregeln erstellen, um Benachrichtigungen zu Repository-Ereignissen zu senden, die für Sie wichtig sind. Die folgenden Schritte zeigen, wie Sie eine Benachrichtigungsregel für ein einzelnes Repository-Ereignis einrichten. Bei diesen Schritten wird vorausgesetzt, dass Sie ein Repository in Ihrem AWS-Konto konfiguriert haben.

Wichtig

Wenn Sie vor dem 5. November 2019 Benachrichtigungen in CodeCommit einrichten, enthalten die für diese Benachrichtigungen verwendeten Amazon-SNS-Themen eine Richtlinie, die es CodeCommit ermöglicht, darin zu veröffentlichen, und die andere Berechtigungen enthält als die für AWS CodeStar Notifications erforderlichen. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie ein für jene Erfahrung erstelltes Thema verwenden möchten, müssen Sie die für AWS CodeStar Notifications erforderliche Richtlinie ergänzend zu der bereits vorhandenen Richtlinie hinzufügen. Weitere Informationen finden Sie unter Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen und Grundlagen zu Benachrichtigungsinhalten und -sicherheit.

1. Öffnen Sie die CodeCommit-Konsole unter https://console.aws.amazon.com/codecommit.

2. Wählen Sie ein Repository aus der Liste aus und öffnen Sie es.

3. Wählen Sie Notify (Benachrichtigung) und dann Create notification rule (Benachrichtigungsregel erstellen) aus. Sie können auch Settings (Einstellungen), Notifications (Benachrichtigungen) und dann Create notification rule (Benachrichtigungsregel erstellen) auswählen.

4. Geben Sie unter Notification name (Benachrichtigungsname) einen Namen für die Regel ein.

5. Wählen Sie unter Detail type (Detailtyp) die Option Basic (Einfach) aus, wenn nur die für Amazon EventBridge bereitgestellten Informationen in der Benachrichtigung enthalten sein sollen. Wählen Sie Full (Vollständig), wenn Sie für Amazon EventBridge bereitgestellte und möglicherweise vom Ressourcenservice oder vom Benachrichtigungsmanager bereitgestellte Informationen berücksichtigen möchten.

   Weitere Informationen finden Sie unter Grundlagen zu Benachrichtigungsinhalten und -sicherheit.

6. Wählen Sie im Bereich Events that trigger notifications (Ereignisse, die Benachrichtigungen auslösen) unter Branches and tags (Zweige und Tags) die Option Created (Erstellt)aus.

7. Wählen Sie unter Targets (Ziele) die Option Create SNS topic (SNS-Thema erstellen) aus.

   Anmerkung

   Wenn Sie das Thema im Rahmen des Erstellens der Benachrichtigungsregel erstellen, wird die Richtlinie, die es CodeCommit ermöglicht, Ereignisse in dem Thema zu veröffentlichen, für Sie angewendet. Durch die Verwendung eines Themas, das für Benachrichtigungsregeln erstellt wurde, kann sichergestellt werden, dass Sie das Thema nur für die Benutzer abonnieren, die Benachrichtigungen zu diesem Repository erhalten sollen.

   Geben Sie hinter dem Präfix codestar-notifications- einen Namen für das Thema ein und wählen Sie anschließend Submit (Absenden) aus.

   Anmerkung

   Wenn Sie ein vorhandenes Amazon-SNS-Thema verwenden möchten, anstatt ein neues zu erstellen, wählen Sie unter Targets (Ziele), dessen ARN aus. Stellen Sie sicher, dass das Thema über die entsprechende Zugriffsrichtlinie verfügt und Abonnentenliste nur die Benutzer enthält, denen Informationen zur Ressource angezeigt werden dürfen. Wenn das Amazon-SNS-Thema vor dem 5. November 2019 für CodeCommit-Benachrichtigungen verwendet wurde, enthält es eine Richtlinie, die es CodeCommit ermöglicht, darin zu veröffentlichen, und die andere Berechtigungen enthält als die für AWS CodeStar Notifications erforderlichen. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie ein für jene Erfahrung erstelltes Thema verwenden möchten, müssen Sie die für AWS CodeStar Notifications erforderliche Richtlinie ergänzend zu der bereits vorhandenen Richtlinie hinzufügen. Weitere Informationen finden Sie unter Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen und Grundlagen zu Benachrichtigungsinhalten und -sicherheit.

8. Wählen Sie Submit (Absenden) und überprüfen Sie die Benachrichtigungsregel.

9. Abonnieren Sie das soeben erstellte Amazon-SNS-Thema mit Ihrer E-Mail-Adresse. Weitere Informationen finden Sie unter Ein Amazon-SNS-Thema, das für Benachrichtigungen verwendet wird, für Benutzer abonnieren.

10. Navigieren Sie zu Ihrem Repository und erstellen Sie einen Testzweig aus dem Standard-Zweig.

11. Nachdem Sie den Zweig erstellt haben, sendet die Benachrichtigungsregel an alle Themenabonnenten eine Benachrichtigung mit Informationen zu diesem Ereignis.