本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 开始使用通知
<a name="getting-started"></a>

开始使用通知的最简单方法是在您的构建项目、部署应用程序、管道或存储库之一上设置通知规则。

**注意**  
首次创建通知规则时，您的账户中会创建服务相关角色。有关更多信息，请参阅 [为 AWS CodeStar 通知使用服务相关角色](using-service-linked-roles.md)。

**Topics**
+ [先决条件](#getting-started-prerequisites)
+ [为存储库创建通知规则](getting-started-repository.md)
+ [为构建项目创建通知规则](getting-started-build.md)
+ [为部署应用程序创建通知规则](getting-started-deploy.md)
+ [为管道创建通知规则](getting-started-pipeline.md)

## 先决条件
<a name="getting-started-prerequisites"></a>

完成 [设置](setting-up.md) 中的步骤。您还需要将为其创建通知规则的资源。
+ [在中创建构建项目 CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html)或使用现有项目。
+ [创建应用程序](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications-create.html)或使用现有部署应用程序。
+ [在中创建管道 CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html)或使用现有管道。
+ [创建 AWS CodeCommit存储库](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-repository.html)或使用现有存储库。

# 为存储库创建通知规则
<a name="getting-started-repository"></a>

您可以创建通知规则，以发送有关对您很重要的存储库事件的通知。以下步骤显示如何在单个存储库事件上设置通知规则。这些步骤是在假设您的 AWS 账户中配置了存储库的情况下编写的。

**重要**  
如果您在 2019 年 11 月 5 日 CodeCommit 之前设置了通知，则用于这些通知的 Amazon SNS 主题将包含一项允许 CodeCommit 向其发布的策略，该策略包含的权限与通知所需的 AWS CodeStar 权限不同。建议不使用这些主题。如果要使用为该体验创建的策略，则除了已有的 AWS CodeStar 通知策略外，还必须添加所需的通知策略。有关更多信息，请参阅[配置通知的 Amazon SNS 主题](set-up-sns.md)和[了解通知内容和安全性](security.md#security-notifications)。

1. 打开 CodeCommit 控制台，网址为[https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/)。

1. 从列表中选择一个存储库并将其打开。

1. 选择 **Notify (通知)**，然后选择 **Create notification rule (创建通知规则)**。您也可以依次选择 **Settings (设置)**、**Notifications (通知)** 和 **Create notification rule (创建通知规则)**。

1. 在 **Notification name（通知名称）**中，输入规则的名称。

1. 如果您只想在通知中 EventBridge 包含提供给 Amazon 的信息，请在 “**详情类型**” 中选择 “**基本**”。如果您想包括提供给 Amazon 的信息 EventBridge 以及可能由资源服务或通知管理器提供的信息，请选择 “**完整**”。

   有关更多信息，请参阅 [了解通知内容和安全性](security.md#security-notifications)。

1. 在 **Events that trigger notifications (触发通知的事件)** 中的 **Branches and tags (分支和标签)** 下，选择 **Created (已创建)**。

1. 在 **Targets（目标）**中，选择 **Create SNS topic（创建 SNS 主题）**。
**注意**  
当您在创建通知规则的过程中创建主题时，将应用允许 CodeCommit 向该主题发布事件的策略。使用为通知规则创建的主题有助于确保您仅订阅要接收有关此存储库的通知的那些用户。

   在 **codestar-notifications-** 前缀后面，输入主题的名称，然后选择 **Submit（提交）**。
**注意**  
如果要使用现有 Amazon SNS 主题而不是创建新主题，请在 **Targets (目标)** 中选择其 ARN。请确保主题具有适当的访问策略，并且订阅者列表仅包含允许查看有关资源的信息的用户。如果 Amazon SNS 主题是在 2019 年 11 月 5 日之前用于 CodeCommit 通知的主题，则该主题将包含一项允许 CodeCommit 向其发布的政策，该策略包含的权限与通知所需的 AWS CodeStar 权限不同。建议不使用这些主题。如果要使用为该体验创建的策略，则除了已有的 AWS CodeStar 通知策略外，还必须添加所需的通知策略。有关更多信息，请参阅[配置通知的 Amazon SNS 主题](set-up-sns.md)和[了解通知内容和安全性](security.md#security-notifications)。

1. 选择 **Submit (提交)**，然后查看通知规则。

1. 以您的电子邮件地址订阅您刚创建的 Amazon SNS 主题。有关更多信息，请参阅 [为用户订阅用于通知的 Amazon SNS 主题](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 导航到您的存储库并从原定设置分支创建测试分支。

1. 创建分支后，通知规则会向所有主题订阅者发送通知，其中包含有关事件的信息。

# 为构建项目创建通知规则
<a name="getting-started-build"></a>

您可以创建通知规则，以发送有关对您非常重要的构建项目事件的通知。以下步骤显示如何在单个构建项目事件上设置通知规则。这些步骤是在假设您的 AWS 账户中配置了构建项目的前提下编写的。

1. 打开 CodeBuild 控制台，网址为[https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)。

1. 从列表中选择构建项目并将其打开。

1. 选择 **Notify (通知)**，然后选择 **Create notification rule (创建通知规则)**。您也可以选择 **Settings (设置)**，然后选择 **Create notification rule (创建通知规则)**。

1. 在 **Notification name（通知名称）**中，输入规则的名称。

1. 

   如果您只想在通知中 EventBridge 包含提供给 Amazon 的信息，请在 “**详情类型**” 中选择 “**基本**”。如果您想包括提供给 Amazon 的信息 EventBridge 以及可能由资源服务或通知管理器提供的信息，请选择 “**完整**”。

   有关更多信息，请参阅 [了解通知内容和安全性](security.md#security-notifications)。

1.  在 **Events that trigger notifications (触发通知的事件)** 中的 **Build phase (构建阶段)** 下，选择 **Success (成功)**。

1. 在 **Targets（目标）**中，选择 **Create SNS topic（创建 SNS 主题）**。
**注意**  
当您在创建通知规则的过程中创建主题时，将应用允许 CodeBuild 向该主题发布事件的策略。使用为通知规则创建的主题有助于确保您仅订阅要接收有关此构建项目的通知的那些用户。

   在 **codestar-notifications-** 前缀后面，输入主题的名称，然后选择 **Submit (提交)**。
**注意**  
如果要使用现有 Amazon SNS 主题而不是创建新主题，请在 **Targets (目标)** 中选择其 ARN。请确保主题具有适当的访问策略，并且订阅者列表仅包含允许查看有关资源的信息的用户。如果 Amazon SNS 主题是在 2019 年 11 月 5 日之前用于 CodeCommit 通知的主题，则该主题将包含一项允许 CodeCommit 向其发布的政策，该策略包含的权限与通知所需的 AWS CodeStar 权限不同。建议不使用这些主题。如果要使用为该体验创建的策略，则除了已有的 AWS CodeStar 通知策略外，还必须添加所需的通知策略。有关更多信息，请参阅[配置通知的 Amazon SNS 主题](set-up-sns.md)和[了解通知内容和安全性](security.md#security-notifications)。

1. 选择 **Submit (提交)**，然后查看通知规则。

1. 以您的电子邮件地址订阅您刚创建的 Amazon SNS 主题。有关更多信息，请参阅 [为用户订阅用于通知的 Amazon SNS 主题](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 导航到您的构建项目并开始构建。

1. 在成功完成构建阶段之后，通知规则将向所有主题订阅者发送通知，其中包含有关该事件的信息。

# 为部署应用程序创建通知规则
<a name="getting-started-deploy"></a>

您可以创建通知规则，以发送有关对您非常重要的部署应用程序事件的通知。以下步骤显示如何在单个构建项目事件上设置通知规则。在编写这些步骤时，假设您已在 AWS 账户中配置一个部署应用程序。

1. 打开 CodeDeploy 控制台，网址为[https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/)。

1. 从列表中选择一个应用程序并将其打开。

1. 选择 **Notify (通知)**，然后选择 **Create notification rule (创建通知规则)**。您也可以选择 **Settings (设置)**，然后选择 **Create notification rule (创建通知规则)**。

1. 在 **Notification name（通知名称）**中，输入规则的名称。

1. 如果您只想在通知中 EventBridge 包含提供给 Amazon 的信息，请在 “**详情类型**” 中选择 “**基本**”。如果您想包括提供给 Amazon 的信息 EventBridge 以及可能由资源服务或通知管理器提供的信息，请选择 “**完整**”。

   有关更多信息，请参阅 [了解通知内容和安全性](security.md#security-notifications)。

   

1.  在 **Events that trigger notifications (触发通知的事件)** 中的 **Deployment (部署)** 下，选择 **Succeeded (已成功)**。

1. 在 **Targets（目标）**中，选择 **Create SNS topic（创建 SNS 主题）**。
**注意**  
当您在创建通知规则的过程中创建主题时，将应用允许 CodeDeploy 向该主题发布事件的策略。使用为通知规则创建的主题有助于确保您仅订阅要接收有关此部署应用程序的通知的那些用户。

   在 **codestar-notifications-** 前缀后面，输入主题的名称，然后选择 **Submit (提交)**。
**注意**  
如果要使用现有 Amazon SNS 主题而不是创建新主题，请在 **Targets (目标)** 中选择其 ARN。请确保主题具有适当的访问策略，并且订阅者列表仅包含允许查看有关资源的信息的用户。如果 Amazon SNS 主题是在 2019 年 11 月 5 日之前用于 CodeCommit 通知的主题，则该主题将包含一项允许 CodeCommit 向其发布的政策，该策略包含的权限与通知所需的 AWS CodeStar 权限不同。建议不使用这些主题。如果要使用为该体验创建的策略，则除了已有的 AWS CodeStar 通知策略外，还必须添加所需的通知策略。有关更多信息，请参阅[配置通知的 Amazon SNS 主题](set-up-sns.md)和[了解通知内容和安全性](security.md#security-notifications)。

1. 选择 **Submit (提交)**，然后查看通知规则。

1. 以您的电子邮件地址订阅您刚创建的 Amazon SNS 主题。有关更多信息，请参阅 [为用户订阅用于通知的 Amazon SNS 主题](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 导航到部署应用程序并启动部署。

1. 部署成功后，通知规则会向所有主题订阅者发送通知，其中包含有关事件的信息。

# 为管道创建通知规则
<a name="getting-started-pipeline"></a>

您可以创建通知规则，以发送有关对您非常重要的管道的事件的通知。以下步骤显示如何在单个管道事件上设置通知规则。这些步骤是在假设您的 AWS 账户中配置了管道的情况下编写的。

1. 打开 CodePipeline 控制台，网址为[https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/)。

1. 从列表中选择一个管道并将其打开。

1. 选择 **Notify (通知)**，然后选择 **Create notification rule (创建通知规则)**。您也可以选择 **Settings (设置)**，然后选择 **Create notification rule (创建通知规则)**。

1. 在 **Notification name（通知名称）**中，输入规则的名称。

1. 如果您只想在通知中 EventBridge 包含提供给 Amazon 的信息，请在 “**详情类型**” 中选择 “**基本**”。如果您想包括提供给 Amazon 的信息 EventBridge 以及可能由资源服务或通知管理器提供的信息，请选择 “**完整**”。

   有关更多信息，请参阅 [了解通知内容和安全性](security.md#security-notifications)。

1. 在 **Events that trigger notifications (触发通知的事件)** 中的 **Action execution (操作执行)** 下，选择 **Started (已开始)**。

1. 在 **Targets（目标）**中，选择 **Create SNS topic（创建 SNS 主题）**。
**注意**  
当您在创建通知规则的过程中创建主题时，将应用允许 CodePipeline 向该主题发布事件的策略。使用为通知规则创建的主题有助于确保您仅订阅要接收有关此管道的通知的那些用户。

   在 **codestar-notifications-** 前缀后面，输入主题的名称，然后选择 **Submit（提交）**。
**注意**  
如果要使用现有 Amazon SNS 主题而不是创建新主题，请在 **Targets (目标)** 中选择其 ARN。请确保主题具有适当的访问策略，并且订阅者列表仅包含允许查看有关资源的信息的用户。如果 Amazon SNS 主题是在 2019 年 11 月 5 日之前用于 CodeCommit 通知的主题，则该主题将包含一项允许 CodeCommit 向其发布的政策，该策略包含的权限与通知所需的 AWS CodeStar 权限不同。建议不使用这些主题。如果要使用为该体验创建的策略，则除了已有的 AWS CodeStar 通知策略外，还必须添加所需的通知策略。有关更多信息，请参阅[配置通知的 Amazon SNS 主题](set-up-sns.md)和[了解通知内容和安全性](security.md#security-notifications)。

1. 选择 **Submit (提交)**，然后查看通知规则。

1. 以您的电子邮件地址订阅您刚创建的 Amazon SNS 主题。有关更多信息，请参阅 [为用户订阅用于通知的 Amazon SNS 主题](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 导航到您的管道，然后选择**发布更改**。

1. 在操作开始时，通知规则会向所有主题订阅者发送通知，其中包含有关事件的信息。