第 8 步:部署和调用示例代理

本页面适用于 ApigeeApigee Hybrid

查看 Apigee Edge 文档。

您在此步骤中执行的操作

请按照以下步骤创建和部署测试 API 代理。最后,通过向 API 代理发送 HTTP 请求来测试该代理。

创建和部署 API 代理

Apigee 的预配过程不会自动为您创建和部署 API 代理。您必须手动创建和部署代理。

Cloud 控制台中的 Apigee 界面

如需创建和部署第一个代理,请执行以下操作:

  1. 在浏览器中打开 Cloud 控制台中的 Apigee 界面
  2. 确保从界面左上角的下拉菜单中选择您的组织名称。组织名称与您的 Google Cloud 项目名称相同。
  3. 在左侧导航窗格中,点击代理开发 > API 代理
  4. 点击 + 创建 (+ Create)。

    系统会打开创建代理页面。

  5. 代理模板框中,选择反向代理(最常见)
  6. 第 1 步:代理详细信息中,使用以下值配置代理:
    参数名称
    代理名称 hello-world
    基本路径 /hello-world
    目标(现有 API) mocktarget.apigee.net
  7. 点击下一步
  8. 第 2 步:政策中的安全:授权下,选择经过(无授权)
  9. 点击下一步
  10. 第 3 步:部署(可选)中,选择要在其中部署代理的环境,然后点击确定
  11. 点击创建

    新的 API 代理会在所选环境中创建和部署。

  12. 系统会显示新创建的代理的代理摘要页面。状态下的绿色对勾标记表示代理已成功部署。如果代理未部署,请参阅部署 API 代理,然后按照相应步骤手动部署代理。
  13. 在左侧导航窗格中,依次选择管理 > 环境 > 环境组
  14. 复制环境组的主机名。您将在后续步骤中使用此主机名来调用 API 代理。

Apigee 界面

如需创建和部署第一个代理,请执行以下操作:

  1. 登录 Apigee 界面
  2. 确保从界面左上角的下拉菜单中选择您的组织名称。组织名称与您的 Google Cloud 项目名称相同。
  3. 在主视图中点击 API 代理
  4. 选择环境下拉列表中,选择一个环境。
  5. 点击新建
  6. 点击反向代理(最常见)
  7. 代理详情页面中,使用以下值配置代理:
    参数名称
    名称 hello-world
    基本路径 /hello-world
    目标(现有 API) https://mocktarget.apigee.net
  8. 点击下一步
  9. 通用政策页面中的安全性:授权下,选择通过(无授权)
  10. 点击下一步
  11. 摘要页面的可选部署下,选择要在其中部署代理的环境。
  12. 点击创建和部署

    新的 API 代理会在所选环境中创建和部署。

  13. 点击 Go to proxy list状态下的绿色对勾标记表示代理已成功部署。如果代理未部署,请参阅部署 API 代理,然后按照相应步骤手动部署代理。
  14. 在左侧导航窗格中,依次选择管理 > 环境 > 组
  15. 复制环境组的主机名。您将在后续步骤中使用此主机名来调用 API 代理。

使用内部访问权限调用代理

如果您在“第 7 步:配置访问路由”中允许内部访问,请按照调用仅限内部访问的 API 代理中的说明操作。

使用外部访问权限调用代理

如果您在“第 7 步:配置访问路由”中允许外部访问,请按照以下步骤操作:

  1. 为您的主机设置 DNS 条目。 您可以通过两种方式完成此任务:
    • 在注册商处,创建一条 A 记录,以便将环境组主机名指向向导页面上配置 DNS 下显示的 IP 地址。例如,如果您的主机名为 sales.example.com,IP 地址为 10.23.0.2,则将 sales.example.com 的记录指向地址 10.23.0.2
    • 使用 Google Cloud DNS 将网址映射到 IP 地址。
  2. 通过在终端窗口中发送以下请求来测试 API 代理:
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
      https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    其中:

    如果请求成功,则会返回字符串 Hello, Guest!。如果请求不成功,请参阅问题排查

后续步骤