第 1 章 API Designer 概述
Red Hat Fuse on OpenShift 提供了基于 Web 的 API Designer,您可以使用它设计符合 OpenAPI 规格 (版本 3 或 2)的 REST API,这是 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 将 REST API 融入到 OpenShift 应用程序解决方案中的 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 应用程序。