注意:此产品的某些方面处于 Beta 版阶段。Hybrid 安装选项是 GA。要加入 Beta 版计划,请与您的 Apigee 代表联系。

排查 Apigee 安装问题

本部分列出了在安装和配置 Apigee 时常见的错误并介绍了可能的解决方法。

以下 HTTP 错误是您可能会遇到的最常见问题:

  • 401 (UNAUTHENTICATED) 表示您的凭据可能超时。请尝试续订授权令牌,如以下示例所示:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

创建新实例

本部分介绍将请求发送到 Apigee 以创建新实例后的常见错误和可能的解决方法:

  • 401 (UNAUTHENTICATED) 表示您的凭据可能超时。请尝试续订授权令牌,如以下示例所示:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED 表示无法容纳您最初请求的 IP 地址范围,您必须请求新的范围。您最初在第 3 步:配置服务网络中创建了一个范围请求。

    要请求 Apigee 为专用服务连接选择 IP 地址的新范围,请执行以下操作:

    1. 执行以下 gcloud 命令:
      gcloud compute addresses create google-svcs-2
        --project=$PROJECT_ID --global --prefix-length=16
        --description="additional peering range for Google services" --network=default
        --purpose=VPC_PEERING

      此命令会创建一个新的范围请求。

      请注意,您必须指定第一个范围的名称(在本例中为“google-svcs”)以及新请求范围的名称(在本例中为“google-svcs-2”)。

    2. 执行以下命令以更新您的连接请求:
      gcloud services vpc-peerings update
        --service=servicenetworking.googleapis.com --network=default
        --ranges=google-svcs,google-svcs-2 --project=$PROJECT_ID

      请注意,vpc-peerings update 命令现在也会同时指定旧 IP 地址范围和新的 IP 地址范围。

      如需了解详情,请参阅 gcloud services vpc-peerings update

创建 Apigee 组织

以下示例展示了当您首次尝试创建组织时,Apigee 可能会显示的常见错误:

创建组织错误

这意味着尚未启用一个或多个必需 API。查看第 2 步:启用 Apigee API 并确保所有 API 均已启用,然后再继续操作。

另外,您可能会遇到以下 HTTP 错误:

  • 401 (UNAUTHENTICATED) 表示您的凭据可能超时。请尝试续订授权令牌,如以下示例所示:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • 404 (Not Found) 可能是以下因素造成的:
    • 您输入的端点/请求网址有误。检查您是否为 API 调用的网域指定了 apigee.googleapis.com
    • 您的项目可能尚未预配 Beta 版访问权限。请与 Apigee 支持联系,确保您的帐号已获得 Beta 版的访问权限。
  • 409 (Conflict) 通常表示指定的组织名称已存在。组织名称必须是全局唯一的。请为组织选择其他名称,然后重新发出命令。(如果您要通过命令行创建组织,请在请求的载荷中指定名称。请记住,您必须创建一个与项目同名的组织,因此除非有错别字,否则不会发生这种情况。)

如果您查看新组织请求的状态,Apigee 可能会返回以下错误:

  • 403 (Permission Denied) 可能表示尚未创建组织。请稍等片刻,然后重试。如果您在首次尝试创建新组织时 Apigee 返回 403,则可能表示您的一个或多个 API 尚未启用。请确保您已启用第 2 步:启用 Apigee API 中所述的所有 API。

部署示例

部署示例代理时,Apigee 可能会返回 502 (Bad Gateway) HTTP 错误。在这种情况下,请尝试以下操作:

  1. 打开 Cloud Console
  2. 检查负载平衡器的运行状况。在 Cloud Console 中,选择网络服务 > 负载平衡负载平衡器标签页会显示项目的所有负载平衡器及其状态。黄色三角形表示负载平衡器后端服务运行状况不佳。
  3. 在确认负载平衡器问题后,请检查运行时实例中的虚拟机,以确保其正常运行且状况良好。
  4. 查看日志文件,看看是否存在错误或可能导致问题的其他类型的问题。
  5. 尝试在 Cloud Console 中对实例组执行滚动式重新启动:
    1. 选择 Compute Engine > 实例组
    2. 在实例组列表中,点击在名称列中无响应的实例组。
    3. 点击滚动式重新启动/替换,如以下示例所示:

      Compute Engine 滚动式重新启动

    4. 在下一个屏幕上,点击重启

      此操作将重启 Envoy 实例。