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.
# Einstieg in die Verwendung von Benachrichtigungen
Der einfachste Weg, um mit der Verwendung von Benachrichtigungen zu beginnen, besteht darin, eine Benachrichtigungsregel für eine(s) Ihrer Build-Projekte, Bereitstellungsanwendungen, Pipelines oder Repositorys einzurichten.
**Anmerkung**
Wenn Sie zum ersten Mal eine Benachrichtigungsregel erstellen, wird in Ihrem Konto eine serviceverknüpfte Rolle erstellt. Weitere Informationen finden Sie unter [Verwenden von serviceverknüpften Rollen für Benachrichtigungen AWS CodeStar](using-service-linked-roles.md).
**Topics**
+ [Voraussetzungen](#getting-started-prerequisites)
+ [Erstellen einer Benachrichtigungsregel für ein Repository](getting-started-repository.md)
+ [Erstellen einer Benachrichtigungsregel für ein Build-Projekt](getting-started-build.md)
+ [Erstellen einer Benachrichtigungsregel für eine Bereitstellungsanwendung](getting-started-deploy.md)
+ [Erstellen einer Benachrichtigungsregel für eine Pipeline](getting-started-pipeline.md)
## Voraussetzungen
Führen Sie die Schritte unter [Einrichtung](setting-up.md) aus. Außerdem benötigen Sie eine Ressource, für die Sie eine Benachrichtigungsregel erstellen.
+ [Erstellen Sie ein Build-Projekt in CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html) oder verwenden Sie ein vorhandenes.
+ [Erstellen Sie eine Anwendung](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications-create.html) oder verwenden Sie eine vorhandene Bereitstellungsanwendung.
+ [Erstellen Sie eine Pipeline in CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html) oder verwenden Sie eine bestehende.
+ [Erstellen Sie ein AWS CodeCommit Repository](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-repository.html) oder verwenden Sie ein vorhandenes.
# 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. Diese Schritte wurden unter der Annahme geschrieben, dass Sie in Ihrem AWS Konto ein Repository konfiguriert haben.
**Wichtig**
Wenn Sie Benachrichtigungen CodeCommit vor dem 5. November 2019 eingerichtet haben, enthalten die Amazon SNS SNS-Themen, die für diese Benachrichtigungen verwendet werden, eine Richtlinie, die es ermöglicht, auf Amazon CodeCommit zu veröffentlichen, die andere Berechtigungen enthält als die, die für AWS CodeStar Benachrichtigungen erforderlich sind. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie eine für dieses Erlebnis erstellte Richtlinie verwenden möchten, müssen Sie zusätzlich zu der bereits vorhandenen Richtlinie die erforderliche Richtlinie für AWS CodeStar Benachrichtigungen hinzufügen. Weitere Informationen erhalten Sie unter [Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen](set-up-sns.md) und [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Öffnen Sie die CodeCommit Konsole unter [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/).
1. Wählen Sie ein Repository aus der Liste aus und öffnen Sie es.
1. 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.
1. Geben Sie unter **Notification name (Benachrichtigungsname)** einen Namen für die Regel ein.
1. Wählen Sie unter **Detailtyp** die Option **Basic** aus, wenn Sie möchten, dass nur die Informationen, die Amazon zur Verfügung gestellt wurden, in der Benachrichtigung EventBridge enthalten sind. Wählen Sie **Vollständig**, wenn Sie Informationen, die Amazon zur Verfügung gestellt wurden, EventBridge und Informationen, die möglicherweise vom Ressourcenservice oder vom Notification Manager bereitgestellt wurden, einbeziehen möchten.
Weitere Informationen finden Sie unter [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. 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.
1. Wählen Sie unter **Targets (Ziele)** die Option **Create SNS topic (SNS-Thema erstellen)** aus.
**Anmerkung**
Wenn Sie das Thema im Rahmen der Erstellung der Benachrichtigungsregel erstellen, wird die Richtlinie, die das Veröffentlichen von Ereignissen zu dem Thema ermöglicht CodeCommit , 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 es sich bei dem Amazon SNS-Thema um ein Thema handelt, das vor dem 5. November 2019 für CodeCommit Benachrichtigungen verwendet wurde, enthält es eine Richtlinie, die es ermöglicht, dort CodeCommit zu veröffentlichen, die andere Berechtigungen enthält als die, die für AWS CodeStar Benachrichtigungen erforderlich sind. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie eine für dieses Erlebnis erstellte Richtlinie verwenden möchten, müssen Sie zusätzlich zu der bereits vorhandenen Richtlinie die erforderliche Richtlinie für AWS CodeStar Benachrichtigungen hinzufügen. Weitere Informationen erhalten Sie unter [Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen](set-up-sns.md) und [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Wählen Sie **Submit (Absenden)** und überprüfen Sie die Benachrichtigungsregel.
1. 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](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navigieren Sie zu Ihrem Repository und erstellen Sie einen Testzweig aus dem Standard-Zweig.
1. Nachdem Sie den Zweig erstellt haben, sendet die Benachrichtigungsregel an alle Themenabonnenten eine Benachrichtigung mit Informationen zu diesem Ereignis.
# Erstellen einer Benachrichtigungsregel für ein Build-Projekt
Sie können Benachrichtigungsregeln erstellen, um Benachrichtigungen über die Ereignisse in Ihrem Build-Projekt zu senden, die für Sie wichtig sind. Die folgenden Schritte zeigen, wie Sie eine Benachrichtigungsregel für ein einzelnes Build-Projektereignis einrichten. Diese Schritte wurden unter der Annahme geschrieben, dass Sie in Ihrem AWS Konto ein Build-Projekt konfiguriert haben.
1. Öffnen Sie die CodeBuild Konsole unter [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Wählen Sie ein Build-Projekt aus der Liste aus und öffnen Sie es.
1. Wählen Sie **Notify (Benachrichtigung)** und dann **Create notification rule (Benachrichtigungsregel erstellen)** aus. Sie können auch **Settings (Einstellungen)** und dann **Create notification rule (Benachrichtigungsregel erstellen)** auswählen.
1. Geben Sie unter **Notification name (Benachrichtigungsname)** einen Namen für die Regel ein.
1.
Wählen Sie unter **Detailtyp** die Option **Basic** aus, wenn Sie möchten, dass nur die Informationen, die Amazon zur Verfügung gestellt wurden, in der Benachrichtigung EventBridge enthalten sind. Wählen Sie **Vollständig**, wenn Sie Informationen, die Amazon zur Verfügung gestellt wurden, EventBridge und Informationen, die möglicherweise vom Ressourcenservice oder vom Notification Manager bereitgestellt wurden, einbeziehen möchten.
Weitere Informationen finden Sie unter [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Wählen Sie im Bereich **Events that trigger notifications (Ereignisse, die Benachrichtigungen auslösen)** unter **Build phase (Build-Phase)** die Option **Success (Erfolg)** aus.
1. Wählen Sie unter **Targets (Ziele)** die Option **Create SNS topic (SNS-Thema erstellen)** aus.
**Anmerkung**
Wenn Sie das Thema im Rahmen der Erstellung der Benachrichtigungsregel erstellen, wird die Richtlinie, die das Veröffentlichen von Ereignissen zu dem Thema ermöglicht CodeBuild , 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 Build-Projekt 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 es sich bei dem Amazon SNS-Thema um ein Thema handelt, das vor dem 5. November 2019 für CodeCommit Benachrichtigungen verwendet wurde, enthält es eine Richtlinie, die es ermöglicht, dort CodeCommit zu veröffentlichen, die andere Berechtigungen enthält als die, die für AWS CodeStar Benachrichtigungen erforderlich sind. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie eine für dieses Erlebnis erstellte Richtlinie verwenden möchten, müssen Sie zusätzlich zu der bereits vorhandenen Richtlinie die erforderliche Richtlinie für AWS CodeStar Benachrichtigungen hinzufügen. Weitere Informationen erhalten Sie unter [Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen](set-up-sns.md) und [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Wählen Sie **Submit (Absenden)** und überprüfen Sie die Benachrichtigungsregel.
1. 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](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navigieren Sie zu Ihrem Build-Projekt, und starten Sie einen Build.
1. Nach erfolgreichem Abschluss der Build-Phase sendet die Benachrichtigungsregel an alle Themenabonnenten eine Benachrichtigung mit Informationen zu diesem Ereignis.
# Erstellen einer Benachrichtigungsregel für eine Bereitstellungsanwendung
Sie können Benachrichtigungsregeln erstellen, um Benachrichtigungen zu den Ereignissen in Ihre Bereitstellungsanwendung zu senden, die für Sie wichtig sind. Die folgenden Schritte zeigen, wie Sie eine Benachrichtigungsregel für ein einzelnes Build-Projektereignis einrichten. Bei diesen Schritten wird davon ausgegangen, dass Sie eine Bereitstellungsanwendung in Ihrem AWS -Konto konfiguriert haben.
1. Öffnen Sie die CodeDeploy Konsole unter [https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/).
1. Wählen Sie eine Anwendung aus der Liste aus und öffnen Sie sie.
1. Wählen Sie **Notify (Benachrichtigung)** und dann **Create notification rule (Benachrichtigungsregel erstellen)** aus. Sie können auch **Settings (Einstellungen)** und dann **Create notification rule (Benachrichtigungsregel erstellen)** auswählen.
1. Geben Sie unter **Notification name (Benachrichtigungsname)** einen Namen für die Regel ein.
1. Wählen Sie unter **Detailtyp** die Option **Basic** aus, wenn Sie möchten, dass nur die Informationen, die Amazon zur Verfügung gestellt wurden, in der Benachrichtigung EventBridge enthalten sind. Wählen Sie **Vollständig**, wenn Sie Informationen, die Amazon zur Verfügung gestellt wurden, EventBridge und Informationen, die möglicherweise vom Ressourcenservice oder vom Notification Manager bereitgestellt wurden, einbeziehen möchten.
Weitere Informationen finden Sie unter [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Wählen Sie im Bereich **Events that trigger notifications (Ereignisse, die Benachrichtigungen auslösen)** unter **Deployment (Bereitstellung)** die Option **Succeeded (Erfolgreich)** aus.
1. Wählen Sie unter **Targets (Ziele)** die Option **Create SNS topic (SNS-Thema erstellen)** aus.
**Anmerkung**
Wenn Sie das Thema im Rahmen der Erstellung der Benachrichtigungsregel erstellen, wird die Richtlinie, die das Veröffentlichen von Ereignissen zu dem Thema ermöglicht CodeDeploy , 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 dieser Bereitstellungsanwendung 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 es sich bei dem Amazon SNS-Thema um ein Thema handelt, das vor dem 5. November 2019 für CodeCommit Benachrichtigungen verwendet wurde, enthält es eine Richtlinie, die es ermöglicht, dort CodeCommit zu veröffentlichen, die andere Berechtigungen enthält als die, die für AWS CodeStar Benachrichtigungen erforderlich sind. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie eine für dieses Erlebnis erstellte Richtlinie verwenden möchten, müssen Sie zusätzlich zu der bereits vorhandenen Richtlinie die erforderliche Richtlinie für AWS CodeStar Benachrichtigungen hinzufügen. Weitere Informationen erhalten Sie unter [Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen](set-up-sns.md) und [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Wählen Sie **Submit (Absenden)** und überprüfen Sie die Benachrichtigungsregel.
1. 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](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navigieren Sie zu Ihrer Bereitstellungsanwendung und starten Sie eine Bereitstellung.
1. Nach erfolgreicher Bereitstellung sendet die Benachrichtigungsregel an alle Themenabonnenten eine Benachrichtigung mit Informationen zu dem Ereignis.
# Erstellen einer Benachrichtigungsregel für eine Pipeline
Sie können Benachrichtigungsregeln erstellen, um Benachrichtigungen über die Ereignisse in Ihrer Pipeline zu senden, die für Sie wichtig sind. Die folgenden Schritte zeigen, wie Sie eine Benachrichtigungsregel für ein einzelnes Pipeline-Ereignis einrichten. Diese Schritte wurden unter der Annahme geschrieben, dass Sie in Ihrem AWS Konto eine Pipeline konfiguriert haben.
1. Öffnen Sie die CodePipeline Konsole unter [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Wählen Sie eine Pipeline aus der Liste aus und öffnen Sie sie.
1. Wählen Sie **Notify (Benachrichtigung)** und dann **Create notification rule (Benachrichtigungsregel erstellen)** aus. Sie können auch **Settings (Einstellungen)** und dann **Create notification rule (Benachrichtigungsregel erstellen)** auswählen.
1. Geben Sie unter **Notification name (Benachrichtigungsname)** einen Namen für die Regel ein.
1. Wählen Sie unter **Detailtyp** die Option **Basic** aus, wenn Sie möchten, dass nur die Informationen, die Amazon zur Verfügung gestellt wurden, in der Benachrichtigung EventBridge enthalten sind. Wählen Sie **Vollständig**, wenn Sie Informationen, die Amazon zur Verfügung gestellt wurden, EventBridge und Informationen, die möglicherweise vom Ressourcenservice oder vom Notification Manager bereitgestellt wurden, einbeziehen möchten.
Weitere Informationen finden Sie unter [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Wählen Sie im Bereich **Events that trigger notifications (Ereignisse, die Benachrichtigungen auslösen)** unter **Action execution (Aktionsausführung)** die Option **Started (Gestartet)** aus.
1. Wählen Sie unter **Targets (Ziele)** die Option **Create SNS topic (SNS-Thema erstellen)** aus.
**Anmerkung**
Wenn Sie das Thema im Rahmen der Erstellung der Benachrichtigungsregel erstellen, wird die Richtlinie, die das Veröffentlichen von Ereignissen zu dem Thema ermöglicht CodePipeline , 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 dieser Pipeline 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 es sich bei dem Amazon SNS-Thema um ein Thema handelt, das vor dem 5. November 2019 für CodeCommit Benachrichtigungen verwendet wurde, enthält es eine Richtlinie, die es ermöglicht, dort CodeCommit zu veröffentlichen, die andere Berechtigungen enthält als die, die für AWS CodeStar Benachrichtigungen erforderlich sind. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie eine für dieses Erlebnis erstellte Richtlinie verwenden möchten, müssen Sie zusätzlich zu der bereits vorhandenen Richtlinie die erforderliche Richtlinie für AWS CodeStar Benachrichtigungen hinzufügen. Weitere Informationen erhalten Sie unter [Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen](set-up-sns.md) und [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
1. Wählen Sie **Submit (Absenden)** und überprüfen Sie die Benachrichtigungsregel.
1. 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](subscribe-users-sns.md#set-up-sns-subscribe).
1. Navigieren Sie zu Ihrer Pipeline, und wählen Sie dann **Release change (Versionswechsel)**aus.
1. Wenn die Aktion gestartet wird, sendet die Benachrichtigungsregel an alle Themenabonnenten eine Benachrichtigung mit Informationen zu dem Ereignis.