2.3. 在 OpenShift 4.x 上安装 API Designer

Red Hat Fuse on OpenShift 提供了 API Designer,它是一个基于 Web 的 API 设计工具,可用于设计 REST API。API Designer Operator 简化了 OpenShift Container Platform 4.x 上的 API Designer 的安装和升级。

作为 OpenShift 管理员,您要将 API Designer Operator 安装到 OpenShift 项目(命名空间)。安装 Operator 后,Operator 会在所选命名空间中运行。但是,要使 API Designer 作为服务(作为 OpenShift 管理员)提供,或者开发人员必须创建一个 API Designer 实例。API Designer 服务提供用于访问 API Designer Web 控制台的 URL。

先决条件

  • 具有 OpenShift 集群的管理员访问权限。
  • 您已将身份验证配置为 registry.redhat.io

流程

  1. 启动 OpenShift 4.x 服务器。
  2. 在 Web 浏览器中,导航到浏览器中的 OpenShift 控制台。使用您的凭证登录到控制台。
  3. Operators,然后点 OperatorHub
  4. 在搜索字段中,键入 API Designer
  5. Red Hat Integration - API Designer 卡。Red Hat Integration - API Designer Operator 安装页面将打开。
  6. Install。此时会打开 Install Operator 页面。

    1. 对于 更新频道,请选择 fuse-console-7.10.x
    2. 对于 Installation 模式,请从集群中的命名空间列表中选择命名空间(项目)。
    3. 对于 Approval Strategy,选择 AutomaticManual 来配置 OpenShift 如何处理 API Designer Operator 的更新。

      • 如果选择 Automatic 更新,当 API Designer Operator 的新版本可用时,OpenShift Operator Lifecycle Manager (OLM)会自动升级 API Designer 的运行实例,而无需人为干预。
      • 如果选择手动 更新,则当有新版 Operator 可用时,OLM 会创建更新请求。作为集群管理员,您必须手动批准该更新请求,才能将 API Designer Operator 更新至新版本。
  7. Install 使 API Designer Operator 可供指定命名空间(项目)使用。
  8. 要验证 API Designer 是否已安装到项目中,点 Operators,然后点 Installed Operators 在列表中看到 Red Hat Integration - API Designer

后续步骤

安装 API Designer Operator 后,API Designer 必须通过创建 API Designer 实例来作为服务添加到 OpenShift 项目中。此任务可以通过两种方式完成:

2.3.1. 将 API Designer 作为一个服务添加到 OpenShift 4.x 项目中

在 OpenShift 4.x 项目中安装了 API Designer 操作器后,您可以(或一个 OpenShift 开发人员)将它添加为 OpenShift 项目的服务。API Designer 服务提供开发人员用来访问 API Designer Web 控制台的 URL。

注意

如需了解 OpenShift 开发人员要作为服务添加到 OpenShift 4.x 项目的步骤,请参阅 设计 API。

先决条件

  • 具有 OpenShift 集群的管理员访问权限。
  • API Designer 操作器安装到当前的 OpenShift 项目中。

流程

  1. 在 OpenShift Web 控制台中,点 Operators,然后点 Installed Operators
  2. Name 列中,点 Red Hat Integration - API Designer
  3. Provided APIs 下,点 Create instance

    此时会打开 API Designer 实例的最小起始模板的默认表单。接受默认值,或者(可选)编辑它们。

  4. 单击 Create 以创建一个新的 apicurito-service。OpenShift 为新的 API Designer 服务启动 pod、服务和其他组件。
  5. 验证 API Designer 服务是否可用:

    1. Operators,然后点 Installed Operators
    2. Provided APIs 列中,点 Apicurito CRD

      Operator Details 页面中,会列出 apicurito-service

  6. 打开 API Designer:

    1. 选择 Networking > Routes
    2. 确保选择了正确的项目。
    3. apicurito-service-ui 行的 Location 列中,单击 URL。

      API Designer Web 控制台在新的浏览器标签页中打开。

2.3.2. 在 OpenShift 4.x 上升级 API Designer

Red Hat OpenShift 4.x 处理对 Operator 的更新,包括 Red Hat Fuse operator。如需更多信息,请参阅 Operator OpenShift 文档

反过来,Operator 更新可触发应用程序升级。应用程序升级如何根据应用程序的配置方式的不同而有所不同。

对于 API Designer 应用程序,升级 API Designer 操作器时,OpenShift 会自动升级集群上的任何 API 设计程序应用程序。

注意

从 API Designer 7.8 升级到 API Designer 7.9 时,正常的 Operator 升级过程无法正常工作。要将 API Designer 从 Fuse 7.8 升级到 Fuse 7.9,您必须删除 7.8 API Designer 操作器,然后安装 7.9 API Designer operator。

2.3.3. API Designer 的 metering 标签

您可以使用 OpenShift Metering Operator 分析已安装的 API Designer 操作器、UI 组件和代码生成器,以确定您是否符合红帽订阅。如需有关 Metering 的更多信息,请参阅 OpenShift 文档

下表列出了 API Designer 的 metering 标签。

表 2.1. API Designer Metering 标签

标签可能的值

com.company

Red_Hat

rht.prod_name

Red_Hat_Integration

rht.prod_ver

7.10

rht.comp

fuse

rht.comp_ver

7.10

rht.subcomp

fuse-apicurito

apicurito-service-ui

apicurito-service-generator

rht.subcomp_t

infrastructure

例子

  • API Designer 操作器 示例:

    apicurito-operator
    com.company: Red_Hat
    rht.prod_name: Red_Hat_Integration
    rht.prod_ver: 7.10
    rht.comp: Fuse
    rht.comp_ver: 7.10
    rht.subcomp: fuse-apicurito
    rht.subcomp_t: infrastructure
  • API Designer UI 组件示例:

    com.company: Red_Hat
    rht.prod_name: Red_Hat_Integration
    rht.prod_ver: 7.10
    rht.comp: Fuse
    rht.comp_ver: 7.10
    rht.subcomp: apicurito-service-ui
    rht.subcomp_t: infrastructure
  • API Designer Generator 组件示例:

    com.company: Red_Hat
    rht.prod_name: Red_Hat_Integration
    rht.prod_ver: 7.10
    rht.comp: Fuse
    rht.comp_ver: 7.10
    rht.subcomp: apicurito-service-generator
    rht.subcomp_t: infrastructure

2.3.4. 在受限环境中安装 API Designer 的注意事项

在受限环境中安装的 OpenShift 集群默认无法访问红帽提供的 OperatorHub 源,因为这些远程源需要足够的互联网连接。在这种情况下,要安装 API designer Operator,您必须完成以下先决条件:

  • 为 Operator Lifecycle Manager (OLM)禁用默认远程 OperatorHub 源。
  • 使用有完全互联网访问的工作站来创建 OperatorHub 内容的本地镜像。
  • 将 OLM 配置为,从本地源而不是默认的远程源安装和管理 Operator。

如需更多信息,请参阅 OpenShift 文档中的 在受限网络中使用 Operator Lifecycle Manager 部分。创建 OperatorHub 的本地镜像后,您可以执行以下步骤。