第 1 章 API Designer 概述
OpenShift 上的红帽 Fuse 提供 API Designer(基于 Web 的 API 编辑器),可用于设计符合 OpenAPI 规格的 REST API(版本 3 或 2),它是一个厂商中立并可移植的 API 服务打开描述格式。API Designer 是 Apicurio Studio 开源项目的"light"版本(https://www.apicur.io/)。这意味着您的 API Designer 会话无状态,您必须将 API 定义保存为每个会话末尾的 JSON 文件。
您还可以根据 REST API 定义,使用 API Designer 生成初步 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 应用程序。