使用 Private Service Connect 的北向网络

本页面适用于 Apigee，但不适用于 Apigee Hybrid。

查看 Apigee Edge 文档。

本文档介绍了如何使用 Private Service Connect (PSC) 配置从客户端到 Apigee 的路由（也称为“北向”流量）。

概览

您可以使用 PSC 将 Apigee VPC 连接到已与 Apigee 对等互连的 VPC 或连接到您控制的任何其他 VPC。这种架构模式无需创建代管式实例组 (MIG)，即可将请求从全球负载均衡器转发到 Apigee。使用 PSC 路由方法，API 代理请求会通过您在 VPC 中安装的全球外部 HTTP(S) 负载均衡器传递到 Apigee VPC 中的单个连接点（称为服务连接）。此配置可让您从任何启用了网络的机器发送 Apigee API 代理请求。请参阅图 1。

请注意以下受支持的北向 PSC 功能：

您可以将 PSC 与任何现有 Apigee 实例搭配使用。
您可以将多个 PSC 网络端点组 (NEG) 关联到基于 Envoy 的 Google Cloud 全球外部 HTTP(S) 负载均衡器。
VPC Service Controls 支持 PSC。
您可以在后端服务上设置离群值检测流量政策，以自动处理故障切换场景。请参阅以下内容了解详细信息：

图 1：专用服务连接

限制

将 PSC 与 Apigee 搭配使用目前存在以下限制：

限制：请注意 PSC 配置的以下限制：

此配置不支持全球外部 HTTP(S) 负载均衡器（经典版）。
对于使用多个 PSC NEG 的故障切换，不支持主动健康检查。请改用离群值检测。
可以通过 PSC 连接到 Apigee 实例的 Google Cloud 项目数量以及您可以为每个项目拥有的 PSC NEG 连接数量均受限。如需了解详情，请参阅 Private Service Connect (PSC) 限制。
如果从 consumerAcceptList 中移除 Google Cloud 项目，则该已移除项目中的现有 PSC NEG 将继续正常运行。但是，所有新的 NEG 都将被拒绝。如果您从 consumerAcceptList 中移除 NEG 关联的项目，则必须删除现有 NEG。或者，您可以重新创建 Apigee 实例，这会在 Apigee 项目中重新创建服务连接。

更新 Apigee 实例的使用方接受列表

2024 年 10 月 10 日，每个项目到 Apigee 实例的 PSC NEG 连接数限制将从 20 提高到 100。对于在此日期之前创建的所有 Apigee 实例，您必须执行本部分中的步骤来更新消费者接受列表，以利用新的限制。您只需升级每个 Apigee 实例一次，即可获得新的连接限制。另请参阅 Private Service Connect (PSC) 限制。

如果您需要在连接到 Apigee 实例的所有 Cloud 项目中总共拥有超过 1000 个 PSC NEG 连接，请与 Google Cloud 支持团队联系。

如需更新 Apigee 实例的消费者接受列表，以利用更高的连接限制，请执行以下步骤：

Cloud 控制台

如需了解详细步骤，请参阅修改“接受的项目”列表。

Apigee API

修改 Apigee 实例的现有使用方接受列表。如需使用实例 API，请执行以下操作：

获取 Apigee API 的身份验证令牌：
```
TOKEN="$(gcloud auth print-access-token)"
```

获取实例的使用方接受列表中的 Cloud 项目列表：

curl https://apigee.googleapis.com/v1/organizations/PROJECT_IDinstances \
  -H "Authorization: Bearer $TOKEN" -H Content-Type:application/json | jq .consumerAcceptList

创建一个名为 update_consumer_accept_list.json 的 JSON 文件，其中包含上一个命令返回的当前已接受项目列表。例如：
```
{
  "consumerAcceptList": [
    "dg-runtime-test1",
    "ne24b79b92c7db623p-tp",
    "dg-runtime-test2",
    "jd2fee78402218863p-tp"
  ]
}
```
（可选）修改该文件以添加更多项目。

使用您创建的 JSON 文件作为输入以更新实例。例如：

curl https://apigee.googleapis.com/v1/organizations/PROJECT_ID/instances?updateMask="consumer_accept_list" \
  -X PATCH -H "Authorization: Bearer $TOKEN" -H Content-Type:application/json -d @update_consumer_accept_list.json

配置 PSC 路由

我们支持将 PSC 用于内部和外部客户端的北向路由。如需了解详细步骤，请参阅 CLI 预配说明的“第 8 步：配置路由”。

使用 PSC 进行多区域扩展

您可以跨多个区域扩展 Apigee 组织，并在新区域中使用 PSC 进行北向路由。如需了解详情，请参阅将 Apigee 扩展到多个区域。

删除 Apigee 实例

如需删除使用 PSC 的 Apigee 实例，请按照以下步骤操作：

从外部负载均衡器中移除和删除 PSC NEG 后端。
使用 Apigee API 删除 Apigee 运行时实例。这是一项长时间运行的操作，最多可能需要 20 分钟才能完成。
（可选）使用 Apigee API 检索长时间运行的操作的状态。