

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

# 适用于 Git 存储库的统一 Webhook
<a name="unified-webhooks"></a>

在向 Git 存储库发送新的提交后，Amplify Hosting 使用 Webhook 自动启动构建。统一 Webhook 功能改进了 Amplify 与 Git 提供商的集成，使您能够将更多 Amplify 应用程序连接到单个存储库。使用统一 Webhook 后，对于存储库中所有关联的应用程序，Amplify 现在将在每个区域使用单个 Webhook。例如，假设存储库同时连接到美国东部（弗吉尼亚州北部）和美国西部（俄勒冈州）区域中的应用程序，则您将有两个统一 Webhook。

在此功能发布之前，Amplify 为关联到一个存储库的每个应用程序创建一个新的 Webhook。如果您在单个存储库中有多个应用程序，则可能会达到各 Git 提供商强制实施的 Webhook 限制，不再能够添加其他应用程序。这给使用单体存储库模式的团队尤其带来挑战，因为在单体存储库模式中，单个存储库中存在多个项目。

统一 Webook 具有以下优势：
+ **克服 Git 提供商的 Webhook 限制**：您可以根据需要将任意数量的 Amplify 应用程序连接到单个存储库。
+ **增强对单体存储库模式的支持**：使用单体存储库模式时，由于多个项目共享一个存储库，您可以获得更好的灵活性和更高的效率。
+ **简化管理**：使用单个存储库 Webhook 来管理多个 Amplify 应用程序，可降低复杂性，减少可能的故障点。
+ **改进工作流集成**：您可以将 Git 提供商分配的 Webhook 用于开发过程中的其他关键工作流。

## 统一 Webhook 入门
<a name="getting-started-unified-webhooks"></a>

**创建新应用程序**

从 Git 存储库将新应用程序部署到 Amplify Hosting 时，系统会自动为您的存储库实施统一 Webhook 功能。有关创建新应用程序的说明，请参阅[开始将应用程序部署到 Amplify Hosting](getting-started.md)。

**更新现有应用程序**

对于现有的 Amplify 应用程序，您必须将 Git 存储库重新连接到该应用程序，才能将现有 Webhook 替换为统一 Webhook。如果您已经达到了 Git 提供商允许的 Webhook 数量上限，则可能无法成功迁移到统一 Webhook。在这种情况下，请手动移除至少一个现有 Webhook，然后再重新连接。

您可以将一个存储库中的多个应用程序部署到不同的 AWS 区域。由于 Amplify 操作属于区域性操作，因此统一 Webhook 将仅对重新连接 Amplify 应用程序的区域中的 Webhook 有效。由于这一原因，您可能会在存储库中同时看到基于应用程序 ID 的 Webhook 和基于区域的统一 Webhook。

按照以下说明将现有 Amplify 应用程序迁移到统一 Webhook。

**将现有 Amplify 应用程序迁移到统一 Webhook**

1. 登录 AWS 管理控制台 并打开 [Amplify](https://console.aws.amazon.com/amplify/) 控制台。

1. 选择要迁移到统一 Webhook 的应用程序。

1. 在导航窗格中，依次选择**应用程序设置**和**分支设置**。

1. 在**分支设置**页面上，选择**重新连接存储库**。

1. 要验证是否成功迁移到统一 Webhook，请导航到 Git 存储库中的 Webhook 设置。您应会看到格式为 `https://amplify-webhooks.Region.amazonaws.com/git-provider` 的单个 Webhook URL。