创建通知规则 - Amazon CodeBuild
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

创建通知规则

您可以使用通知规则在发生重要更改（例如，构建成功和失败）时通知用户。通知规则指定用于发送通知的事件和 Amazon SNS 主题。有关更多信息，请参阅什么是通知？

注意

此功能在中国（北京）区域和中国（宁夏）区域不可用。

您可以使用控制台或 Amazon CLI 为创建通知规则 Amazon CodeBuild。

创建通知规则（控制台）

  1. 登录 Amazon Web Services Management Console 并打开 CodeBuild 控制台，网址为https://console.aws.amazon.com/codebuild/。

  2. 选择构建，再选择构建项目，然后选择要在其中添加通知的构建项目。

  3. 在构建项目页面上，选择通知，然后选择创建通知规则。您也可以转到构建项目的设置页面，然后选择创建通知规则。

  4. 在通知名称中，输入规则的名称。

  5. 如果您只想在通知中 EventBridge 包含提供给 Amazon 的信息，请在 “详情类型” 中选择 “基本”。如果您想包括提供给 Amazon 的信息 EventBridge 以及可能由 CodeBuild 或通知管理器提供的信息，请选择 “全部”。

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

  6. 在触发通知的事件中，选择要为其发送通知的事件。有关详细信息，请参阅构建项目的通知规则的事件。

  7. 在目标中，执行下列操作之一：

    • 如果您已经将资源配置为用于通知，请在选择目标类型中，选择聊天应用程序中的 Amazon Q Developer (Slack) 或 SNS 主题。在选择目标中，选择客户端名称（适用于在聊天应用程序中的 Amazon Q Developer 中配置的 Slack 客户端）或亚马逊 SNS 主题的亚马逊资源名称 (ARN)（适用于已经配置了通知所需策略的 Amazon SNS 主题）。

    • 如果您尚未将资源配置为与通知一起使用，请选择创建目标，然后选择 SNS 主题。在 codestar-notifications- 之后提供主题的名称，然后选择创建。

    注意

    • 如果您在创建通知规则的过程中创建 Amazon SNS 主题，则为您应用允许通知功能将事件发布到主题的策略。使用为通知规则创建的主题有助于确保您仅订阅要接收有关此资源的通知的那些用户。

    • 在创建通知规则的过程中，您不能在聊天应用程序客户端中创建 Amazon Q Developer。如果您在聊天应用程序 (Slack) 中选择 Amazon Q Developer，您将看到一个按钮，指示您在聊天应用程序的 Amazon Q Developer 中配置客户端。选择该选项可在聊天应用程序中打开 Amazon Q 开发者控制台。有关更多信息，请参阅在聊天应用程序中配置通知和 Amazon Q Developer 之间的集成。

    • 如果您想使用现有 Amazon SNS 主题作为目标，则必须添加所需的策略 AWS CodeStar 除了该主题可能存在的任何其他政策外，还会收到通知。有关更多信息，请参阅为通知配置 Amazon SNS 主题以及了解通知内容和安全性。

  8. 要完成规则创建，请选择提交。

  9. 您必须为用户订阅规则的 Amazon SNS 主题，然后他们才能接收通知。有关更多信息，请参阅为用户订阅作为目标的 Amazon SNS 主题。您还可以在聊天应用程序中设置通知与 Amazon Q Developer 之间的集成，以便向 Amazon Chime 聊天室发送通知。有关更多信息，请参阅在聊天应用程序中配置通知和 Amazon Q Developer 之间的集成。

创建通知规则（Amazon CLI）

  1. 在终端或命令提示符处，运行 create-notification rule 命令以生成 JSON 骨架：

    aws codestarnotifications create-notification-rule --generate-cli-skeleton > rule.json

    您可以将此文件命名为所需的任意名称。在本示例中，文件命名为 rule.json。

  2. 在纯文本编辑器中打开 JSON 文件，然后对其进行编辑，以包括该规则所需的资源、事件类型和目标。以下示例显示了一条MyNotificationRule为编译项目命名的通知规则，该项目MyBuildProject在 Amazon 帐号中名为 ID 123456789012。codestar-notifications-MyNotificationTopic当构建成功时，系统会向名为 “生成成功时” 的 Amazon SNS 主题发送通知，并附上完整的详细信息类型：

    {
    "Name": "MyNotificationRule",
    "EventTypeIds": [
        "codebuild-project-build-state-succeeded"
    ],
    "Resource": "arn:aws:codebuild:us-east-2:123456789012:MyBuildProject",
    "Targets": [
        {
            "TargetType": "SNS",
            "TargetAddress": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyNotificationTopic"
        }
    ],
    "Status": "ENABLED",
    "DetailType": "FULL"
}

    保存该文件。

  3. 通过使用您刚编辑的文件，在终端或命令行上，再次运行 create-notification-rule 命令以创建通知规则：

    aws codestarnotifications create-notification-rule --cli-input-json  file://rule.json

  4. 如果成功，该命令将返回通知规则的 ARN，类似于以下内容：

    {
    "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}