为存储库创建通知规则 - 开发工具控制台

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

为存储库创建通知规则

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

重要

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

  1. 打开 CodeCommit 控制台 (https://console.aws.amazon.com/codecommit)。

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

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

  4. 在 Notification name (通知名称) 中，输入规则的名称。

  5. 如果您只想在通知中包含提供给 Amazon EventBridge 的信息，则在 Detail type (详细信息类型) 中，选择 Basic (基本)。如果您希望包含提供给 Amazon EventBridge 的信息以及资源服务或通知管理器可能提供的信息，选择 Full (完整)。

    有关更多信息，请参阅了解通知内容和安全性。

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

  7. 在 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 主题 和 了解通知内容和安全性：

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

  9. 以您的电子邮件地址订阅您刚创建的 Amazon SNS 主题。有关更多信息，请参阅为用户订阅用于通知的 Amazon SNS 主题。

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

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