6.5. 导入和发布示例 API 供应商快速启动集成
Fuse Online 提供了一个 API 供应商快速入门集成,您可以导入到 Fuse Online 环境中。此快速入门包括任务管理 API 的 OpenAPI 文档。导入快速启动集成后,您可以检查流,然后发布集成。完成下面描述的步骤后,TaskAPI 集成将运行并准备好执行。
API 供应商快速启动可帮助您快速了解如何配置、发布和测试 API 供应商集成。但是,它不是 API 提供程序集成很有用的实际示例。对于真实示例,假设您已使用 Fuse Online 发布几个简单的集成。您可以定义 OpenAPI 文档来触发这些集成的执行。要做到这一点,您将编辑每个 OpenAPI 操作的流程,使其与您发布的简单集成几乎相同。
先决条件
- Fuse Online 在浏览器中打开。
流程
导入 TaskAPI 快速启动集成:
-
进入 https://github.com/syndesisio/syndesis-quickstarts/tree/1.8/api-provider 并下载
TaskAPI-export.zip。 - 在 Fuse Online 中,在左侧导航面板中,单击 Integrations。
- 在右上角,单击 Import。
-
将您下载的
TaskAPI-export.zip文件拖到 Import 页面中。Fuse Online 表示它已成功导入该文件。 - 在左侧导航面板中,点 Integrations 查看您刚才导入的 TaskAPI 集成的条目。虽然该条目表示需要配置,但此集成已准备好发布。
-
进入 https://github.com/syndesisio/syndesis-quickstarts/tree/1.8/api-provider 并下载
-
在 TaskAPI 条目中,点
,然后点 Edit 显示此 API 提供的操作列表。
检查每个操作的流:
点其 Create flow 按钮显示该流的视觉化。
每个流已经有一个数据库连接、一个或多个数据映射程序步骤,以及完成流的 Provided API 返回路径 步骤。
- 对于 Invoke SQL 步骤,单击 Configure 以查看连接执行的 SQL 语句。然后单击 Cancel 以返回到该操作的视觉化流。
- 对于数据映射程序步骤,点 Configure 以查看映射程序。然后单击 Cancel 以返回到视觉化。
- 对于 Provided API return Path 步骤,这是每个操作流中的最后一步,点 Configure 以查看操作可能会发送到调用者的 HTTP 返回代码。点 Cancel 返回视觉化。
- 检查一个操作流后,点 Integrations> TaskAPI> Operation 下拉菜单,然后选择另一个操作。
- 重复这一部分步骤,以检查每个流。
检查流后,单击 Publish,如果您想要,请编辑集成名称,然后单击 Save 并发布。
Fuse Online 显示此集成的摘要页面,并在其装配、构建、部署和开始集成时显示发布进度。
当 TaskAPI 集成摘要页面显示 Running 时,Fuse Online 会显示 Task API 服务的外部 URL。它类似如下:
https://i-task-api-proj319352.6a63.fuse-ignite.openshiftapps.com/api/这是 Fuse Online 使 Task API 服务可用的地方。REST API 调用指定以这个基本 URL 开头的 URL。
如果您在 OpenShift Container Platform 上使用 Fuse Online,如果外部 URL 不在集成摘要页面中,则管理员已设置
OPENSHIFT_MANAGEMENT_URL_FOR3SCALE环境变量。当设置此环境变量时,Red Hat 3scale 会发布您的 API 供应商集成,这意味着 3scale 控制对集成 API 的访问。要测试集成,请打开 3scale 仪表板来获取集成的 URL。如果您不希望 Red Hat 3scale 控制对集成 API 的访问,您可以禁用发现。通过查看集成摘要页面,在 Fuse Online 中执行此操作。在此页面上,单击 Disable discovery。Fuse 在线重新发布集成并提供外部 URL 来调用集成执行。
您可以为每个 API 供应商集成启用或禁用发现。