第 10 步:部署 API 代理

现在,您已经配置了 Google Cloud 和 Hybrid 界面,并且安装和配置了运行时,接下来您可以了解它们如何协同工作。

1. 使用 Apigee 界面创建新的 API 代理

本部分介绍了如何使用 API 代理向导在该界面中创建新的 API 代理。

如需使用 API 代理向导创建简单的 API 代理,请执行以下操作

  1. 在浏览器中打开 Apigee 界面
  2. 从左上角的下拉菜单中选择您的组织。
  3. 在主视图中依次选择开发 > API 代理
  4. 点击新建。API 代理向导随即启动。
  5. 选择反向代理(最常见)。

    系统将显示代理详细信息视图。

  6. 使用以下设置配置代理:
    • 代理名称:输入“myproxy”。本部分的其余步骤假定这是代理的 ID。
    • 代理基本路径:自动设置为“/myproxy”。代理基本路径是用于向 API 发出请求的网址的一部分。Edge 使用网址来匹配传入的请求并将其路由到相应的 API 代理。
    • (可选)说明:为您的新 API 代理输入说明,例如“使用简单代理测试 Apigee Hybrid”。
    • 目标(现有 API):输入“https://mocktarget.apigee.net”。此操作会定义 Apigee 在向 API 代理发送的请求上调用的目标网址。mocktarget 服务托管在 Apigee 上,并返回简单的数据。它不需要 API 密钥或访问令牌。

    您的 API 代理的详细信息应如下所示:

  7. 点击下一步
  8. 政策屏幕上,选择直通(无授权) (Pass through (no authorization)) 作为安全选项。
  9. 点击下一步
  10. 摘要屏幕上,选择要将代理部署到的环境,然后点击创建并部署

    Hybrid 会生成代理(有时称为代理软件包):

  11. 点击 Go to proxy list

    Apigee 会显示代理视图,其中显示 API 代理列表。新代理应显示有绿色状态指示图标,表示该代理已部署。

2. 调用 API 代理

当界面指示代理已部署时,您可以尝试使用 cURL 或您选择的 REST 客户端调用该代理。例如:

  1. 确保将 DOMAIN 环境变量设置为项目和组织设置 - 第 3 步:创建环境组中环境组的主机名所使用的域名。
    echo $DOMAIN
  2. 使用以下命令找到 Apigee 入站流量网关的外部 IP 地址和端口:

    kubectl get svc -n apigee -l app=apigee-ingressgateway

    输出应如下所示:

    NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
    apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
  3. 将外部 IP 和端口导出到变量:
    export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
    export INGRESS_PORT=PORT_NUMBER
  4. 调用 API 代理:
    curl  -H Host:$DOMAIN --resolve \
      $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
      https://$DOMAIN:$INGRESS_PORT/myproxy -k

    例如:

    curl  -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k

如需详细了解如何构建和部署 API 代理,请参阅构建第一个代理概览