亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

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

# 发送通知来自 CodeCatalyst
<a name="notifications"></a>

您可以在中设置通知来监控您的项目和资源 CodeCatalyst。用户可以在他们所属的任何项目中选择要接收其电子邮件的项目事件。您还可以选择配置在团队消息应用程序（例如 Slack）中发送给整个团队的通知，方法是配置 CodeCatalyst 空间和 Slack 工作区之间的访问权限，然后为要发送到该 Slack 工作区中的一个或多个频道的项目配置通知。在 CodeCatalyst 空间和 Slack 工作区之间配置访问权限后，项目成员还可以选择添加自己的 Slack 成员， IDs 这样他们就可以直接收到有关互联的 Slack 工作空间和频道中的 CodeCatalyst 事件的通知。

**注意**  
可以发送到 Slack 的项目事件集与用户可以选择通过电子邮件接收通知的事件集不同。

**Topics**
+ [通知的工作原理是什么？](notifications-concepts.md)
+ [开始使用 Slack 通知](getting-started-notifications.md)
+ [从 CodeCatalyst 发送 Slack 和电子邮件通知](notifications-manage.md)

# 通知的工作原理是什么？
<a name="notifications-concepts"></a>

您可以将项目设置为向团队消息收发应用程序（例如 Slack）提供通知。



## 需要具有通知的哪些权限？
<a name="notifications-concepts-permissions"></a>

任何项目成员都可以在中配置、查看、更新或删除频道的通知设置 CodeCatalyst。不过，只有拥有**空间管理员**角色的用户才能添加或删除 Slack 工作区。所有用户都可以为他们所属的项目配置他们希望接收的有关哪些项目事件的电子邮件 CodeCatalyst。

## 我可以配置哪些 CodeCatalyst 事件的通知？
<a name="notifications-concepts-events"></a>

您可以配置为 CodeCatalyst 向一个或多个 Slack 频道发送有关工作流程事件的通知。在 CodeCatalyst 项目和 Slack 之间配置通知后，项目用户可以选择添加自己的 Slack 成员 ID，以便在 Slack 频道中直接接收有关事件的消息。 CodeCatalyst 添加其 Slack 成员的用户 IDs 将在为其项目配置的 Slack 频道 IDs 中收到直接提及，这有助于提高人们对他们关心的事件的认识。

您还可以选择要接收有关哪些事件的电子邮件。这些电子邮件将发送到为您的 AWS Builder ID 配置的电子邮件地址。

## 如何显示通知？
<a name="notifications-concepts-delivery"></a>

您可以配置为 CodeCatalyst 向一个或多个 Slack 频道发送通知。您需要授权 CodeCatalyst 才能授予访问您的 Slack 工作空间的权限。提供授权后， CodeCatalyst 可以向您配置的 Slack 频道发送通知。如果项目成员选择添加其 Slack 成员 ID，他们可以在为该项目配置的 Slack 频道中收到有关 CodeCatalyst事件的提及。

## 我如何设置通知？
<a name="notifications-concepts-setup"></a>

电子邮件通知配置为的一部分 CodeCatalyst。项目用户可以在**我的设置**页面中选择与他们希望接收的电子邮件相关的事件。

要设置项目资源的 Slack 通知，您必须完成以下高级任务。

**设置通知（高级任务）**

1. 在中 CodeCatalyst，您可以在 CodeCatalyst 和消息客户端（例如 Slack）之间**建立连接**。在连接 Slack 工作区后，该工作区将可供空间中的所有项目使用。
**注意**  
只有拥有空间管理员角色的用户才能添加或删除 Slack 工作区。

1. 在中的项目中 CodeCatalyst，**添加您希望团队接收通知的频道**。

1. 在中 CodeCatalyst，您可以**打开各种事件（例如工作流程运行失败）的通知**，并指定要将通知发送到哪个渠道。

有关详细步骤，请参阅[开始使用 Slack 通知](getting-started-notifications.md)。

在 CodeCatalyst 空间和 Slack 之间配置通知后，用户可以选择添加自己的 Slack 成员， IDs 以直接接收有关为其项目配置的 Slack 频道中 CodeCatalyst 事件的消息，

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

创建项目后，您可以设置 Slack 通知，以帮助您的团队监控项目资源。

这些步骤将引导您首次设置Slack通知。 CodeCatalyst如果您已经配置了通知，请参阅[从 CodeCatalyst 发送 Slack 和电子邮件通知](notifications-manage.md)。

**注意**  
可以发送到通知频道的项目事件集与用户可以选择通过电子邮件接收通知的事件集不同。有关更多信息，请参阅 [从 CodeCatalyst 发送 Slack 和电子邮件通知](notifications-manage.md)。

**Topics**
+ [先决条件](#getting-started-notifications-prerequisites)
+ [第 1 步： CodeCatalyst 连接到你的 Slack 工作空间](#getting-started-notifications-connect-slack)
+ [第 2 步：将你的 Slack 频道添加到 CodeCatalyst](#getting-started-notifications-add-slack-channel)
+ [第 3 步：测试从 Slack 发送 CodeCatalyst 的通知](#getting-started-notifications-next-steps)
+ [步骤 4：后续步骤](#getting-started-notifications-test)

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

在开始之前，您需要：
+ 一个 CodeCatalyst 空间。有关创建 CodeCatalyst 空间和首次登录的信息，请参阅[设置并登录 CodeCatalyst设置并登录 CodeCatalyst](setting-up-topnode.md)。
+ 一个 CodeCatalyst 项目。有关更多信息，请参阅 [创建项目](projects-create.md)。
+ 具有**项目管理员或**空间管理员****角色的 CodeCatalyst 帐户。有关更多信息，请参阅 [使用用户角色授予访问权限](ipa-roles.md)。
+ 一个可以访问的 Slack 账户和 Slack 工作空间。 CodeCatalyst
+ 一个用于发送通知的 Slack 频道。 CodeCatalyst 频道可以是公有的或私有的。

## 第 1 步： CodeCatalyst 连接到你的 Slack 工作空间
<a name="getting-started-notifications-connect-slack"></a>

只有拥有**空间管理员**角色的用户才能添加或删除 Slack 工作区。添加或删除 Slack 工作区会影响该空间中的所有项目。要在 CodeCatalyst 和 Slack 之间建立连接，请使用您的 Slack 工作区 CodeCatalyst 执行安全的 OAuth 身份验证握手。

按照以下说明 CodeCatalyst 连接到您的 Slack 工作区。

**注意**  
针对每个 Slack 工作区，只需要执行一次此操作。然后，您可以通过 Slack 频道设置通知。

**要 CodeCatalyst 连接到你的 Slack 工作空间**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 导航到您的项目。

1. 在导航窗格中，选择**项目设置**。

1. 选择**通知**选项卡。

1. 选择**配置通知**。

1. 选择**连接到 Slack 工作区**。

1. 阅读对话框内容，然后选择**连接到 Slack 工作区**。

1. 在**聊天应用程序中的 Amazon Q 开发者版**消息上：

   1. 在右上角，选择包含您的频道的 Slack 工作区。

   1. 选择**允许**。

   您将返回到 CodeCatalyst 控制台。

1. 继续[第 2 步：将你的 Slack 频道添加到 CodeCatalyst](#getting-started-notifications-add-slack-channel)。

## 第 2 步：将你的 Slack 频道添加到 CodeCatalyst
<a name="getting-started-notifications-add-slack-channel"></a>

你需要使用 Slack 频道 ID 才能将你的频道添加到。 CodeCatalyst

**获取 Slack 频道 ID**

1. 登录 Slack。有关更多信息，请参阅[登录到 Slack](https://slack.com/help/articles/212681477-Sign-in-to-Slack)。

1. 前往 Slack 工作区，其中包含您希望通知送达的频道。有关更多信息，请参阅[在 Slack 工作区之间切换](https://slack.com/help/articles/1500002200741-Switch-between-workspaces)或[登录其他 Slack 工作区](https://slack.com/help/articles/212681477-Sign-in-to-Slack)。

1. 在导航窗格中，打开希望通知送达的频道的上下文（右键单击）菜单，然后选择**打开频道详细信息**。

   频道 ID 将显示在对话框底部。

1. 复制**频道 ID** 值。下一步中需要使用该值。

使用你刚才复制的频道 ID，你现在可以将你的 Slack 频道连接到。 CodeCatalyst

**要将你的 Slack 频道添加到 CodeCatalyst**

1. 在开始之前，如果您的 Slack 频道是私有频道，请按如下方式将聊天应用程序中的 Amazon Q 开发者版添加到该频道：

   1. 在 Slack 频道的消息框中，输入 **@aws** 并从对话框中选择 **AWS 应用程序**。

   1. 按 Enter。

      此时会出现 Slackbot 消息，表明聊天应用程序中的 Amazon Q 开发者版不在私有频道中。

   1. 选择**邀请他们**，邀请聊天应用程序中的 Amazon Q 开发者版访问该频道。

1. 在 CodeCatalyst 控制台中，选择 “**下一步**”。

1. 在**频道 ID** 中，粘贴您之前获得的 Slack 频道 ID。

1. 在**频道名称**中，输入名称。我们建议使用 Slack 频道名称。

1. 选择**下一步**。

1. 在**选择通知事件**中，选择要针对其接收通知的事件类型。

1. 选择**结束**。

## 第 3 步：测试从 Slack 发送 CodeCatalyst 的通知
<a name="getting-started-notifications-next-steps"></a>



将项目配置为发送工作流状态通知后，您可以在 Slack 中查看通知。

**在 Slack 中查看通知**

1. 在您的 CodeCatalyst 项目中，[手动启动工作流程](workflows-manually-start.md)以完成工作流程运行并在运行完成时收到状态通知。

1. 在 Slack 中，查看您为通知设置的频道。您的通知会显示每次工作流运行的最新状态以及工作流是失败还是成功。

## 步骤 4：后续步骤
<a name="getting-started-notifications-test"></a>

为您的 CodeCatalyst 空间配置了 Slack 工作空间后，您可以添加其他 Slack 频道现有 CodeCatalyst 项目，并在创建新项目后将其添加到新项目中。您还可以让项目用户知道他们可以为自己的 Slack 成员配置个人 Slack 通知 IDs，并配置他们将接收电子邮件的事件。有关更多信息，请参阅 [从 CodeCatalyst 发送 Slack 和电子邮件通知](notifications-manage.md)。

# 从 CodeCatalyst 发送 Slack 和电子邮件通知
<a name="notifications-manage"></a>

您可以将 CodeCatalyst 配置为发送有关项目中发生的事件的通知。CodeCatalyst 可以向消息收发客户端（例如 Slack 频道）发送通知。让 CodeCatalyst 向 Slack 频道发送消息有助于确保您的整个团队都知道重要事件，例如工作流故障。（可选）您可以选择让 CodeCatalyst 在它发送的 Slack 消息中 @mention 您，这样您就会收到相应的私信（DM）。

CodeCatalyst 还可以通过电子邮件直接向您发送通知。将发送有关任何您具有成员身份的项目中的事件的电子邮件通知。这些电子邮件将发送到在您的 AWS 构建者 ID 中配置的电子邮件地址。

**注意**  
可以发送到 Slack 频道的事件与通过电子邮件发送的事件不同。

**Topics**
+ [配置电子邮件通知](notifications-personal.md)
+ [向 Slack 频道发送通知](notifications-projects.md)
+ [配置 Slack 私信](notifications-personal-slack.md)
+ [编辑通知频道的通知](notifications-edit.md)
+ [移除频道](notifications-remove-channel.md)

# 配置电子邮件通知
<a name="notifications-personal"></a>

您可以选择接收有关任何您具有成员身份的项目中的事件的电子邮件通知。这些电子邮件将发送到在您的 AWS 构建者 ID 中配置的电子邮件地址。默认情况下，您将收到有关所有可发送电子邮件的项目事件的电子邮件。<a name="notifications-personal-email"></a>

**为项目事件配置电子邮件通知**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在顶部菜单栏中，选择您的个人资料徽章，然后选择**我的设置**。 CodeCatalyst **我的设置**页面打开。
**提示**  
您还可以通过转到项目或空间的成员页面，然后从成员列表中选择您的姓名，找到您的用户个人资料。

1. 在**电子邮件通知**中，在列表中找到要配置电子邮件通知的项目，然后选择**编辑**。

1. 选择要接收其电子邮件的事件，然后选择**保存**。

# 向 Slack 频道发送通知
<a name="notifications-projects"></a>

您可以将 CodeCatalyst 配置为向团队的 Slack 频道发送有关项目事件的通知。通过执行此操作，您可以帮助确保整个团队了解重要事件，例如工作流运行失败。

**注意**  
项目的任何成员都可以管理发送到该项目的频道的通知。不过，只有拥有**空间管理员**角色的用户才能添加或删除 Slack 工作区。

按照以下说明操作，添加将向其发送通知的 Slack 频道。

**为通知添加 Slack 频道**

1. 如果您添加的是第一个 Slack 频道，请改为参阅[开始使用 Slack 通知](getting-started-notifications.md)。

   设置第一个频道后，请返回此过程以设置其他频道。

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 导航到您的项目。

1. 在导航窗格中，选择**项目设置**。

1. 选择**通知**选项卡。

1. 选择**添加频道**。

1. 选择 **选择工作区**，然后选择包含要向其发送通知的频道的 Slack 工作区。

   如果您的 Slack 工作区不在列表中，则可以按照[开始使用 Slack 通知](getting-started-notifications.md)中的说明操作来添加它。

1. 在输入**频道 ID** 之前，如果要添加的 Slack 频道是私人频道，请完成以下步骤：

   1. 在 Slack 频道的消息框中，输入 **@aws** 并从弹出窗口中选择 **AWS 应用程序**。

   1. 按 Enter。

      此时会出现 Slackbot 消息，表明聊天应用程序中的 Amazon Q 开发者版不在私有频道中。

   1. 选择**邀请他们**，邀请聊天应用程序中的 Amazon Q 开发者版访问该频道。

1. 在 CodeCatalyst 的**频道 ID** 字段中，输入 Slack 频道 ID。要查找 ID，请转到 Slack，再在导航窗格中右键单击频道，然后选择**打开频道详细信息**。

   频道 ID 将显示在对话框底部。

1. 在**频道名称**中，输入名称。我们建议使用 Slack 频道名称。

1. 在**选择通知事件**中，选择要针对其接收通知的事件类型。

1. 选择**添加**。

# 配置 Slack 私信
<a name="notifications-personal-slack"></a>

如果已将 CodeCatalyst 项目配置为[向 Slack 频道发送通知](notifications-projects.md)，则也可以私信（DM）形式发送这些通知。通过以 DM 的形式将通知直接发送给您，有助于提高您对拥有角色的项目中发生的事件的认识。要启用 DM，您必须将您的 Slack 成员 ID 添加到 CodeCatalyst。

**配置 Slack 私信**

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 在顶部菜单栏中，选择您的个人资料徽章，然后选择**我的设置**。这将打开 CodeCatalyst **我的设置**页面。
**提示**  
您还可以通过转到项目或空间的成员页面，然后从成员列表中选择您的姓名，找到您的用户个人资料。

1. 在**个人 Slack 通知**中，选择**连接 Slack ID**，然后选择**连接到 Slack 工作区**。这将打开一个单独的窗口。
**提示**  
除非具有**空间管理员**角色的用户为您的 CodeCatalyst 空间添加了 Slack 工作区，否则无法配置此选项。有关更多信息，请参阅[开始使用 Slack 通知](getting-started-notifications.md)和[向 Slack 频道发送通知](notifications-projects.md)。

1. 在权限请求窗口中，确保工作区的名称与为 CodeCatalyst 空间配置的 Slack 工作区匹配。选择**允许**以允许聊天应用程序中的 Amazon Q 开发者版访问工作区。此窗口将关闭，并且 Slack 工作区会将**连接**状态显示为**已连接**。
**提示**  
如果连接状态未发生更改，请检查连接 Slack 工作区时是否出错。您可能需要向上滚动以查看错误。

1. 要停止接收个人 Slack 通知，请选择已连接的 Slack 工作区，然后选择**断开连接 Slack ID**。

# 编辑通知频道的通知
<a name="notifications-edit"></a>

您可以更改通知将转至的频道，也可以全局关闭特定通知。

**编辑通知**

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 导航到您的项目。

1. 在导航窗格中，选择**项目设置**。

1. 选择**通知**选项卡。

1. 选择**编辑通知**。

1. 请执行以下操作之一：
   + 要向特定频道发送通知，请从下拉列表中选择该频道。
   + 要全局关闭通知，请选择通知旁边的开关。
   + 要停止向特定频道发送通知，请选择该频道上的 **X**。

1. 选择**保存**。

# 移除频道
<a name="notifications-remove-channel"></a>

您可以从 Amazon CodeCatalyst 中移除 Slack 频道。通过移除 Slack 频道，有关所选 CodeCatalyst 项目的通知将不再发送到该频道。

**移除频道**

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 导航到您的项目。在导航窗格中，选择**项目设置**。

1. 在**项目设置**页面上，选择**通知**选项卡。

1. 选择要移除的频道旁边的指示器，然后选择**移除频道**。在确认窗口中，选择**确定**。