配置存储库通知 - Amazon CodeCommit
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

配置存储库通知

您可以通过配置通知来确保存储库用户收到存储库事件的通知。在配置通知时,订阅用户将收到有关您指定的事件的电子邮件,例如在有人对某个提交发表评论时。

通知事件类型分为以下类别:

  • Pull request update events:如果您选择此选项,则在以下情况下,用户会收到电子邮件:

    • 创建或关闭拉取请求。

    • 使用代码更改更新拉取请求。

    • 拉取请求的标题或说明发生更改。

  • Pull request comment events:如果您选择此选项,则当有人在拉取请求中发表评论或回复评论时,用户会收到电子邮件。

  • Commit comment events:如果您选择此选项,则当有人对拉取请求外的提交发表评论时,用户会收到电子邮件。这包括对以下内容的评论:

    • 提交中的代码行。

    • 提交中的文件。

    • 提交本身。

    有关更多信息,请参阅 评论提交

要使用 Amazon CodeCommit 控制台为中的存储库配置通知 CodeCommit,您必须将以下托管策略或等效权限附加到您的 IAM 用户:

  • CloudWatchEventsFullAccess

  • 亚马逊 SNS FullAccess

注意

AWSCodeCommitFullAccess策略中包含同等权限,这是配置存储库通知所必需的。如果您已应用此策略,则不需要其他两个策略。如果您应用了自定义策略,则可能需要对其进行修改以包含 CloudWatch 活动和 Amazon SNS 所需的权限。

为存储库配置通知
  1. 打开 CodeCommit 控制台,网址为 https://console.aws.amazon.com/codesuite/codecommit/home

  2. Repositories (存储库) 中,选择要在其中配置通知的存储库的名称。

  3. 在导航窗格中,选择 Settings(设置)。选择通知

  4. 选择 Set up (设置)

  5. 选择要包含在存储库 CloudWatch 事件规则中的事件类型。

    在 CodeCommit 存储库中配置通知
  6. SNS 主题中,从您的 Amazon Web Services 账户的 Amazon SNS 主题列表中选择一个主题,或者创建一个主题以供此存储库使用。

    注意

    如果您创建了一个主题,则可以从 CodeCommit控制台管理该策略的订阅。如果您使用了现有主题,则无法管理该主题的订阅,除非您有权管理 Amazon SNS 中所有主题的订阅。有关更多信息,请参阅 Amazon Simple Notification Service 开发人员指南

    如果您创建一个主题,请在主题名称中,在下划线后输入该主题的名称。(已为您输入主题名称的第一部分。请保留名称的第一部分)。在显示名称中,输入可选的短名称。选择创建

  7. 要添加存储库用户的电子邮件地址,请在 Subscribers (订阅者) 中选择 Add (添加)。在添加电子邮件订阅者中,输入存储库用户的电子邮件地址,然后选择保存。一次只能添加一个电子邮件地址。

    注意

    当您选择 Save 时,将向该地址发送一封确认电子邮件。不过,当您还在 Manage subscriptions 中时,订阅状态不会更新。

    在将所有电子邮件地址添加到订阅者列表中后,选择 Close

    提示

    Amazon SNS 会协调和管理到订阅端点以及电子邮件地址的消息传输和发送。终端节点包括 Web 服务器、电子邮件地址、Amazon 简单队列服务队列和 Amazon Lambda 函数。有关更多信息,请参阅《Amazon SNS 开发人员指南》中的什么是 Amazon Simple Notification Service?将 Amazon SNS 消息发送到 HTTP/HTTPS 端点

  8. 要完成通知配置,请选择 Save

为存储库配置通知后,您可以查看为存储库自动创建 CloudWatch 的事件规则。

重要

请勿编辑或删除此规则。更改或删除该规则可能会导致操作问题。例如,电子邮件可能无法发送给订阅者,或者您可能无法更改中存储库的通知设置 CodeCommit。

查看存储库 CloudWatch 的事件规则
  1. 登录 Amazon Web Services Management Console 并打开 CloudWatch 控制台,网址为 https://console.aws.amazon.com/cloudwatch/

  2. 在导航栏中,在 Events 下选择 Rules

  3. 选择您的存储库的规则。规则名称显示在存储库设置中的 Notifications 选项卡上。

  4. 查看规则摘要信息。

    重要

    请勿编辑、删除或禁用此规则。