使用 ESPv2 为 Cloud Run 函数设置 Endpoints OpenAPI

本页面介绍如何在 Cloud Run 函数上设置 Cloud Endpoints。Endpoints 使用 Extensible Service Proxy V2 (ESPv2) 作为 API 网关。如需为 Cloud Run 函数提供 API 管理功能，请将预构建的 ESPv2 容器部署到 Cloud Run。然后，使用 Cloud Run 函数 Identity and Access Management (IAM) 保护函数，以便 ESPv2 可以调用它们。

通过此设置，ESPv2 会拦截发送给您的函数的所有请求，并在调用函数之前执行所有必要的检查（例如身份验证）。当函数响应时，ESPv2 会收集并报告遥测数据，如下图所示。 您可以在 Google Cloud 控制台中的 Endpoints > 服务页面上查看函数的指标。

图表：显示了使用 ESPv2 和 Cloud Functions 的 Cloud Endpoints 架构。

如需大致了解 Cloud Endpoints，请参阅关于 Endpoints 和 Endpoints 架构。

迁移到 ESPv2

以前版本的 Endpoints 支持在 Cloud Run 函数中使用 Extensible Service Proxy (ESP)。如果您有要迁移到 ESPv2 的现有 API，请参阅迁移到 Extensible Service Proxy V2 了解更多信息。

任务列表

学习本教程时，请使用以下任务列表。完成本教程所需的所有任务。

  1. 创建一个 Google Cloud 项目，如果您尚未部署自己的 Cloud Run 函数，请部署一个示例后端函数。请参阅准备工作。
  2. 为 ESPv2 服务预留 Cloud Run 主机名。请参阅预留 Cloud Run 主机名。
  3. 创建描述 API 的 OpenAPI 文档，并配置到 Cloud Run 函数的路由。请参阅配置 Endpoints。
  4. 部署 OpenAPI 文档以创建托管式服务。请参阅部署 Endpoints 配置。
  5. 使用您的 Endpoints 服务配置构建新的 ESPv2 Docker 映像。请参阅构建新的 ESPv2 映像。