适用于 Git 存储库的统一 Webhook - AWS Amplify 托管
统一 Webhook 入门

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

适用于 Git 存储库的统一 Webhook

在向 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 入门

创建新应用程序

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

更新现有应用程序

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

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

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

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

  1. 登录 AWS 管理控制台 并打开 Amplify 控制台。

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

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

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

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