Apigee Integration 和 Apigee 代理集成目标使用入门

公告：Application Integration 现在可供您的 Google Cloud 项目使用。现在，您可以在同一 Google Cloud 项目中同时使用 Apigee Integration 和 Application Integration 了。了解详情

本教程介绍如何使用 Apigee 代理向导创建具有集成目标的代理。代理利用现有集成中的 API 触发器引用来启动集成中的一系列步骤。

以下步骤介绍了如何配置集成目标代理，以在代理被调用时运行成功的集成。

准备工作

• 确认您的 Apigee 登录凭据和组织详细信息。在 Apigee 界面中，需要此信息才能访问 Apigee Integration 功能和代理向导。
• 创建并发布具有 API 触发器和至少一个任务的集成。
  • 如果您尚未创建使用 API 触发器的集成，请按照 Apigee Integration 入门中的步骤操作。
  • 记下您创建的集成或要使用的现有集成的名称，稍后会用到。
• 在创建了 Apigee 组织的同一 Google Cloud 项目中创建一个 Google 服务账号，然后执行以下操作：
  • 将 Apigee Integration Invoker 角色 (roles/integrations.apigeeIntegrationInvokerRole) 分配给服务账号。如需了解预定义的 Apigee Integration 角色，请参阅预定义的 IAM 角色。
  • 允许您的用户账号（主账号）使用 iam.serviceAccounts.actAs 权限将服务账号附加到资源。如需了解服务账号权限，请参阅服务账号身份验证角色。

  部署 API 代理时，您必须提供此服务账号。

创建 Apigee Integration 目标代理

执行以下操作，在 Apigee 界面中创建集成目标代理：

1. 转到 Apigee 界面并登录。
2. 使用界面左上角的下拉菜单选择您的组织。
3. 在主视图中点击 API 代理。

   或者，您也可以在左侧导航菜单中依次选择开发 > API 代理。

4. 从环境下拉列表中选择要在其中创建新的 API 代理的环境。
5. 点击新建。
6. 在显示的代理类型中选择集成目标。

   此时将启动“创建代理”向导。

7. 在代理详情配置页面中，提供以下详细信息：
   • 名称：输入代理的名称。

     代理名称可以包含字母数字字符、短划线和下划线。

   • 基本路径：系统会根据代理名称自动填充。

     基本路径是用于向 API 发出请求的网址的一部分。Apigee 使用该网址来匹配传入的请求并将其路由到相应的 API 代理。

   • 说明：（可选）输入代理的简要说明。

     例如 Proxy test for Apigee Integration。

   • 集成区域：从下拉列表中选择集成区域。
   • 集成目标：从下拉列表中选择集成目标的名称。请注意，集成目标列表会根据所选的集成区域填充。
   • 触发器：从下拉列表中选择与集成关联的 API 触发器。
   • 端点类型：选择同步。
8. 点击下一步。
9. 在常用政策配置页面中，保留默认选项，然后点击下一步。
10. 在摘要页面中，点击创建。

    集成目标代理将成功创建。

部署代理

执行以下步骤以部署新创建的代理：

1. 在 Apigee 界面中，依次选择开发 > API 代理。

   界面会显示 API 代理及其部署状态的列表。

2. 从环境下拉列表中，选择要将 API 代理部署到的环境。

3. 点击要部署的最近创建的代理。默认情况下，界面会显示概览页面。

4. 如需部署更改，请先点击部署以显示部署对话框。
5. 输入以下内容：
   • 修订版本：您要部署的代理的修订版本号。
   • 环境：要在其中部署代理的环境。
   • 服务账号：为代理创建的服务账号。
6. 点击部署。

界面即会开始部署所选修订版本。 代理部署最多可能需要一分钟才能完成。

部署代理后，部署部分中的状态列会显示一个绿色图标，表明已部署代理的修订版本 1。

注意：代理的设置集成请求政策定义中没有显式的 Authentication 元素。Apigee 会自动向请求添加身份验证令牌。

为使设置集成请求政策成功进行身份验证，您必须使用具有运行集成所需 IAM 角色的服务账号来部署集成目标。如需详细了解如何部署 API 代理，请参阅在 Apigee 上部署。

测试集成目标代理

从终端窗口运行以下命令以调用代理并触发集成：

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

其中，YOUR_ENV_GROUP_HOSTNAME 是包含代理部署环境的环境组的主机名。

例如：

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

如需确认已通过调用代理触发集成，请执行以下操作：

1. 打开 Apigee 界面。
2. 点击开发 > 集成。
3. 搜索或选择上面的步骤中创建的集成的名称，然后点击集成名称。
4. 点击日志。
5. 验证触发的集成是否存在执行日志。如需查看日志详细信息，请点击相应行以展开执行详情。

更新代理请求载荷（可选）

按照以下步骤更新代理请求载荷：

1. 在 Apigee 界面中，在左侧导航菜单中依次选择开发 > API 代理。
2. 点击刚刚创建的代理。

   默认情况下，界面会在代理编辑器中显示该代理的概览标签页。

3. 点击开发标签页。
4. 在导航器窗格中的政策标题下选择设置集成请求。
5. 取消对 <Parameters> 块的备注，然后输入参数详细信息。

   如需指定各个参数，请使用 <Parameter> 元素。如需指定参数数组，请使用 <ParameterArray> 元素。

   注意：为简单起见，本教程中保留了 Parameters 块的备注。Apigee Integration 支持许多可作为设置集成请求政策的一部分传递的参数。如需了解详情和示例，请参阅 SetIntegrationRequest 政策。
6. 点击保存。

后续步骤

探索集成设计器布局，并了解所有概念中描述的各种集成概念。