第 1 章 API 设计器概述
Red Hat Fuse on OpenShift 提供了 API Designer (基于 Web 的 API 编辑器),您可以使用它设计符合 OpenAPI 规格的 REST API (版本 3 或 2),这是 API 服务的厂商中立且可移植的开放描述格式。API Designer 是 Apicurio Studio 开源项目的"亮点"版本(https://www.apicur.io/)。这意味着您的 API Designer 会话是无状态的,您必须在每个会话末尾将 API 定义保存为 JSON 文件。
您还可以使用 API Designer 根据 REST API 定义生成初始 Fuse 项目。在 Fuse 开发环境中,您可以完成项目的 Camel 路由并构建项目。最后,您可以在 OpenShift 上的 Fuse 上部署生成的 REST 服务。
以下是如何使用 API Designer 在 OpenShift 应用程序解决方案中的 Fuse 中纳入 REST API 的概述:
- 添加 API Designer 作为服务到 OpenShift 项目。
在 API Designer 中:
- 使用 API Designer 创建 API 定义。将 REST API 定义保存为 JSON 文件到本地文件系统。您可以在编辑会话的任意点保存 API 定义,即使 API 定义没有完成。
- 将 API 定义上传到 API Designer。
- 根据当前的 REST API 定义生成 Fuse Camel 项目。API Designer 提供了一个可下载 zip 文件,其中包含完整的 Maven 项目。
- 在 Fuse 开发环境中,完成由生成的 Fuse 项目提供的框架实施。
- 构建 Fuse 应用并将其部署到 OpenShift。
- (可选)将 Fuse 应用程序与红帽 3scale API 管理集成,使用 3scale 服务发现功能查找并配置 Fuse 应用程序。