配置 Eventarc 触发器

本页介绍了如何在 Application Integration 中配置 Eventarc 触发器。

借助 Eventarc 触发器，您可以根据通过 Eventarc Standard 路由的事件运行集成。使用 Eventarc 触发器，您可以构建由各种 Google Cloud 服务、第三方服务和自定义事件来源的事件触发的集成流。例如，您可以使用 该触发器在将新对象上传到 Cloud Storage 存储桶时启动集成。

在 Google Cloud 控制台中，您可以通过以下方式创建和配置 Eventarc 触发器：

准备工作

在配置 Eventarc 触发器之前，请启用 Eventarc API 和 Pub/Sub API：

启用 API 所需的角色

如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您 创建了项目，则可能已通过 所有者角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。

启用 API

注意事项

配置 Eventarc 触发器时，请考虑以下事项：

  • 如果在集成发布期间由于 配置错误而导致 Eventarc 触发器创建失败，您的集成仍会发布，但触发器不会处于活跃状态。

    如需解决此问题，请取消发布集成，仔细检查并更正 Eventarc 触发器配置，然后重新发布集成。 您可以在 Google Cloud 控制台 工具 栏中点击 （通知），查看 Eventarc 触发器创建状态。

  • 发布集成的新版本并修改 Eventarc 触发器 配置会自动将旧触发器替换为新触发器。这样可确保您的 集成始终使用最新的触发器配置并删除所有过时的触发器。
  • 如果您发布集成的新版本并使用相同的 Eventarc 触发器及其配置，则不会创建新触发器。相反，系统会为您的新集成版本重复使用现有的 Eventarc 触发器。

通过 Application Integration 创建 Eventarc 触发器

如需通过 Application Integration 创建 Eventarc 触发器 ，请执行以下步骤：

  1. 在 Application Integration 中添加 Eventarc 触发器
  2. 在集成编辑器中配置 Eventarc 触发器

添加 Eventarc 触发器

如需向集成添加 Eventarc 触发器，请完成以下步骤：

  1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

    转到 Application Integration

  2. 在导航菜单中，点击集成

    此时会显示集成列表 页面，其中列出了 Google Cloud 项目中的所有可用集成。

  3. 选择现有集成，或点击创建集成 以创建新集成。

    如需创建新的集成，请执行以下操作：

    1. 在创建集成 窗格中输入名称和说明。
    2. 选择集成的区域。
    3. 为集成选择服务帐号。您可以随时通过集成工具栏中的 集成摘要 窗格更改或更新集成的服务帐号详细信息。
    4. 点击创建 。

    新创建的集成会在集成编辑器中打开。

  4. 在集成编辑器的导航栏中，点击触发器 以查看可用触发器列表。
  5. 在集成编辑器中拖放 Eventarc 元素。

配置 Eventarc 触发器

如需配置 Eventarc 触发器，请点击集成编辑器中的 Eventarc Trigger 元素。此时会显示 Eventarc 触发器 配置窗格 ，其中显示以下字段：

  • 标签 ：（可选）Eventarc 触发器在集成中的可见名称。您可以将标签更改为您选择的名称。
  • 备注 ：（可选）您可以添加备注，以提供有关触发器的其他信息。
  • 点击 配置 Eventarc 触发器 ，然后在 Eventarc 触发器编辑器 中提供以下输入：
    • 触发器名称：输入触发器的名称。
    • 触发器类型：选择以下触发器类型之一：
      • Google 来源：选择此选项可为 Pub/Sub、Cloud Storage、Firestore 和其他 Google 事件提供方创建触发器。
      • 自定义：选择此选项可为自定义事件来源创建触发器。
      • 第三方：选择此选项可为提供 Eventarc 来源的非 Google 提供方创建触发器。如需了解详情，请参阅 Eventarc 中的第三方事件。
    • 事件提供方：选择触发器的事件提供方。事件提供方列表取决于触发器类型。如需了解详情，请参阅 事件提供方和目的地。
    • 事件类型：选择触发器的事件类型。触发器配置 因您选择的事件提供方而异。如需了解详情，请参阅 事件类型。
    • 区域：选择触发器的区域。
    • 过滤条件：（可选）添加过滤条件，以选择符合您的条件的 API。例如，如果您按特定名称过滤 API，则只有在更新符合过滤条件的 API 时，系统才会触发事件。
    • 服务账号：选择要用于触发器的服务账号。如果您未选择服务帐号，则触发器在调用服务时会使用 Compute Engine 默认服务帐号作为 其身份。与触发器关联的服务帐号 必须具有调用服务所需的权限。

    • 失败时重试：如果目的地无法处理事件，请选择此选项以启用触发器重试。
    • 网络连接：选择要用于触发器的网络连接。此列表是根据项目中创建的网络连接生成的。

      网络连接有助于服务提供方 Virtual Private Cloud (VPC) 网络与使用方 VPC 网络之间的通信。 Eventarc 使用配置的网络连接与使用方 VPC 网络中托管的内部 HTTP 端点建立连接，从而实现事件数据的传送。如需详细了解如何创建和管理网络连接，请参阅创建和管理网络连接。

  • 如需保存触发器配置，请点击保存触发器 。

使用 Eventarc 控制台创建 Eventarc 触发器

如需通过 Eventarc 控制台页面创建 Eventarc 触发器，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Eventarc > 触发器 页面。

    转到“触发器”

    触发器 页面会列出项目中的所有触发器。

  2. 点击 创建触发器。
  3. 在创建触发器 页面中，提供以下输入：
    1. 触发器名称：输入触发器的名称。
    2. 触发器类型：选择以下触发器类型之一：
      • Google 来源：选择此选项可为 Pub/Sub、 Cloud Storage、Firestore 和其他 Google 事件提供方创建触发器。
      • 自定义：选择此选项可为自定义事件来源创建触发器。
      • 第三方：选择此选项可为提供 Eventarc 来源的非 Google 提供方创建触发器。如需了解详情，请参阅 Eventarc 中的第三方事件。
    3. 事件提供方：选择触发器的事件提供方。事件提供方列表取决于触发器类型。如需了解详情，请参阅事件提供方和目的地。
    4. 事件类型：选择触发器的事件类型。触发器配置因您选择的事件提供方而异。如需了解详情，请参阅事件类型。
    5. 事件数据内容类型：选择事件内容的数据类型。选择 application/json 或 application/protobuf 。
    6. 区域：选择触发器的区域。
    7. 服务账号：选择要用于触发器的服务账号。如果您未选择服务帐号，则触发器在调用服务时会使用 Compute Engine 默认服务账号作为其身份。与触发器关联的服务帐号必须具有调用服务所需的权限。
    8. 事件目的地：选择 Application Integration。
    9. 选择集成：选择要为其创建 触发器的集成。如果集成已发布，Application Integration 会创建集成的新 草稿版本，以向其中添加 Eventarc 触发器。
    10. 网络连接：选择要用于触发器的网络连接。此列表 是根据项目中创建的网络连接生成的。

      网络连接有助于服务提供方 Virtual Private Cloud (VPC) 网络与使用方 VPC 网络之间的通信。Eventarc 使用配置的网络连接与使用方 VPC 网络中托管的内部 HTTP 端点建立连接，从而实现事件数据的传送。如需详细了解网络连接，请参阅关于网络连接。

  4. 点击打开集成 。

    Application Integration 编辑器页面随即打开，其中已选择集成，并且已向集成添加新的 Eventarc 触发器 元素。

  5. 点击 Eventarc 触发器 元素，然后打开触发器配置窗格。
  6. 在 Eventarc 触发器编辑器 页面中查看并验证触发器配置。
  7. 将新的 Eventarc 触发器 连接到集成流，然后发布集成。