Eventarc 触发器声明您对某个事件或一系列事件感兴趣。如需配置事件路由，您可以为触发器指定过滤条件，包括事件来源和目标 Cloud Run 服务。
Eventarc 通过 HTTP 请求以 CloudEvents 格式将事件传送到事件接收器。
以下说明介绍如何配置到 Cloud Run 服务的事件路由（由直接 API Gateway 事件触发）。如需了解详情，请参阅支持的直接事件列表。
准备创建触发器
在创建触发器之前，请先完成以下前提条件：
控制台
在 Google Cloud 控制台的“项目选择器”页面上，选择或创建 Google Cloud 项目。
启用 Cloud Logging、Eventarc 和 Eventarc Publishing API。
如果适用，请启用与直接事件相关的 API。例如，对于 API Gateway 事件，请启用 API Gateway API。
如果您还没有用户管理的服务账号，请创建一个，然后为其授予必要的角色和权限，以便 Eventarc 可以管理目标服务的事件。
在 Google Cloud 控制台中，进入创建服务账号页面。
选择您的项目。
在服务账号名称字段中，输入一个名称。Google Cloud 控制台会根据此名称填充服务账号 ID 字段。
在服务账号说明字段中，输入说明。例如
Service account for event trigger。点击创建并继续。
如需提供适当的访问权限，请在选择角色列表中，针对经过身份验证的或未经过身份验证的调用向您的服务账号授予所需的 Identity and Access Management (IAM) 角色。如需了解详情，请参阅 Cloud Run 目标的角色和权限。
如需添加其他角色，请点击 添加其他角色，然后添加其他各个角色。
点击继续。
如需完成账号的创建过程，请点击完成。
gcloud
在 Google Cloud 控制台中，激活 Cloud Shell。
Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。
启用 Cloud Logging、Eventarc 和 Eventarc Publishing API。
gcloud services enable logging.googleapis.com \ eventarc.googleapis.com \ eventarcpublishing.googleapis.com
如果适用，请启用与直接事件相关的 API。例如，对于 API Gateway 事件，请启用
apigateway.googleapis.com。如果您还没有用户管理的服务账号，请创建一个，然后为其授予必要的角色和权限，以便 Eventarc 可以管理目标服务的事件。
创建服务账号：
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
将
SERVICE_ACCOUNT_NAME替换为服务账号的名称。该名称必须介于 6 到 30 个字符之间，且可以包含小写字母数字字符和短划线。在服务账号创建完毕后，无法再更改其名称。为经过身份验证或未经身份验证的调用授予所需的 Identity and Access Management (IAM) 角色或权限。如需了解详情，请参阅 Cloud Run 目标的角色和权限。
创建触发器
您可以使用 Google Cloud CLI 或通过 Google Cloud 控制台创建 Eventarc 触发器。
控制台
- 在 Google Cloud 控制台中，进入 Eventarc 触发器页面。
- 点击 创建触发器。
- 输入触发器名称。
这是触发器的 ID，必须以字母开头。最多可包含 63 个小写字母、数字或连字符。
- 对于触发器类型，选择 Google 来源。
- 在事件提供方列表中，选择 API Gateway。
请注意，关联的 Google Cloud 文档中使用的事件提供方名称可能没有 Cloud 或 Google Cloud 前缀。例如，在控制台中，Memorystore for Redis 称为 Google Cloud Memorystore for Redis。
- 在事件类型列表中，从“直接”事件中选择一种事件类型。
- 如需指定事件载荷的编码，请在事件数据内容类型列表中选择 application/json 或 application/protobuf。
请注意，JSON 格式的事件载荷大于 Protobuf 中格式的事件载荷。这可能会影响可靠性，具体取决于您的事件目标位置及其事件大小限制。如需了解详情，请参阅已知问题。
- 在区域列表中，选择生成事件的 Google Cloud 服务所在的区域。
如需了解详情，请参阅 Eventarc 位置。
- 如果适用于事件提供方，请点击添加过滤条件并指定以下内容：
- 选择将调用您的服务或工作流的服务账号。
或者，您可以创建新的服务账号。
这用于指定与触发器相关联且您之前向其授予 Eventarc 所需的特定角色的 Identity and Access Management (IAM) 服务账号电子邮件。
- 在事件目标位置列表中，选择 Cloud Run。
- 选择一项服务。
这是接收触发器事件的服务的名称。该服务必须与触发器位于同一项目中，并在事件生成时，接收作为 HTTP POST 请求发送到其根网址路径 (
/) 的事件。 - （可选）您可以指定将传入请求发送到的服务网址路径。
这是触发器的事件应该发送到的目的地服务上的相对路径。例如：
/、/route、route、route/subroute。 - 点击创建。
创建触发器之后，您便无法修改事件来源过滤条件。请创建新触发器，并删除旧触发器。 如需了解详情，请参阅管理触发器。
gcloud
您可以通过运行包含必需和可选标志的 gcloud eventarc triggers create 命令来创建触发器。
gcloud eventarc triggers create TRIGGER \
--location=LOCATION \
--destination-run-service=DESTINATION_RUN_SERVICE \
--destination-run-region=DESTINATION_RUN_REGION \
--event-filters="type=EVENT_FILTER_TYPE" \
--event-filters="COLLECTION_ID=RESOURCE_ID" \
--event-filters-path-pattern="COLLECTION_ID=PATH_PATTERN" \
--event-data-content-type="EVENT_DATA_CONTENT_TYPE" \
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
替换以下内容：
TRIGGER：触发器的 ID 或完全限定标识符。LOCATION：Eventarc 触发器的位置。或者，您可以设置eventarc/location属性；例如gcloud config set eventarc/location us-central1。为避免任何性能和数据驻留问题，位置必须与生成事件的 Google Cloud 服务的位置匹配。如需了解详情，请参阅 Eventarc 位置。
-
DESTINATION_RUN_SERVICE：为触发器接收事件的 Cloud Run 服务的名称。该服务可以位于任何 Cloud Run 支持位置，无需与触发器位于同一位置。但是，该服务必须与触发器位于同一项目中，并在事件生成时，接收作为 HTTP POST 请求发送到其根网址路径 (/) 的事件。 -
DESTINATION_RUN_REGION：（可选）目标 Cloud Run 服务所在的区域。如果未指定，系统将假定服务与触发器位于同一区域。 EVENT_FILTER_TYPE：事件的标识符。 方法的 API 调用成功时会生成事件。 对于长时间运行的操作，事件仅会在操作结束时生成，并且仅在操作成功执行时才会生成。 如需查看支持的事件类型的列表，请参阅 Eventarc 支持的事件类型。
COLLECTION_ID（可选）：可充当事件过滤条件的资源组件，它是以下组件之一：apiapiconfiggateway
RESOURCE_ID：用作关联集合的过滤值的资源的标识符。如需了解详情，请参阅资源 ID。PATH_PATTERN：过滤资源时要应用的路径模式。-
EVENT_DATA_CONTENT_TYPE：（可选）事件载荷的编码。 可以为application/json或application/protobuf。默认编码为application/json。请注意，JSON 格式的事件载荷大于 Protobuf 中格式的事件载荷。这可能会影响可靠性，具体取决于您的事件目标位置及其事件大小限制。如需了解详情，请参阅已知问题。
SERVICE_ACCOUNT_NAME：用户管理的服务账号的名称。PROJECT_ID：您的 Google Cloud 项目 ID。
备注：
--event-filters="type=EVENT_FILTER_TYPE"标志是必需的。如果未设置其他事件过滤条件，则匹配所有资源的事件。EVENT_FILTER_TYPE创建后无法更改。如需更改EVENT_FILTER_TYPE，请创建一个新触发器并删除旧触发器。- 每个触发器可以有多个事件过滤条件，在一个
--event-filters=[ATTRIBUTE=VALUE,...] 标志内以英文逗号分隔，您也可以重复使用该标志来添加更多过滤条件。只有符合所有过滤条件的事件会被发送到目的地。不支持通配符和正则表达式；但是，使用--event-filters-path-pattern标志时，您可以定义资源路径模式。 --service-account标志用于指定与触发器关联的 Identity and Access Management (IAM) 服务账号电子邮件。- （可选）您可以使用
--destination-run-path标志指定触发器的事件应发送到的目标 Cloud Run 服务的相对路径。
示例：
gcloud eventarc triggers create helloworld-trigger \
--location=us-central1 \
--destination-run-service=helloworld-events \
--destination-run-region=us-central1 \
--event-filters="type=google.cloud.apigateway.gateway.v1.updated" \
--event-filters-path-pattern="gateway=my-gateway-*" \
--service-account=${SERVICE_ACCOUNT_NAME}@${PROJECT_ID}.iam.gserviceaccount.com
此命令会为标识为 google.cloud.apigateway.gateway.v1.updated 的事件创建一个名为 helloworld-trigger 的触发器，并匹配以 my-gateway- 开头的 gateway ID 的事件。
Terraform
您可以使用 Terraform 为 Cloud Run 目标创建触发器。如需了解详情，请参阅使用 Terraform 创建触发器。
列出触发器
如需确认触发器已创建，您可以使用 Google Cloud CLI 或通过 Google Cloud 控制台列出 Eventarc 触发器。
控制台
在 Google Cloud 控制台中，进入 Eventarc 触发器页面。
本页面列出了所有位置的触发器，并包含名称、区域、事件提供程序、目标位置等详细信息。
如需过滤触发器，请执行以下操作：
- 点击 过滤条件或过滤条件触发器字段。
- 在属性列表中，选择一个选项以过滤触发器。
您可以选择单个属性，或使用逻辑运算符
OR添加更多属性。如需对触发器进行排序，请点击任意受支持的列标题旁边的 排序。
gcloud
运行以下命令可列出触发器：
gcloud eventarc triggers list --location=-
此命令会列出所有位置的触发器，并包含名称、类型、目标位置和状态等详细信息。