迁移 3scale

Red Hat 3scale API Management 2.13

迁移或升级 3scale API 管理及其组件

Red Hat Customer Content Services

摘要

将 3scale 从模板迁移到基于 Operator 的安装。另外,查找要将 3scale 及其组件升级到最新版本的信息。

前言

本指南提供了将 Red Hat 3scale API Management 从模板迁移到基于 Operator 的安装的信息、将 3scale 安装从 2.12 升级到 2.13 所需的详细信息,以及在基于 Operator 的部署中升级 APIcast 的步骤。

要将 3scale On-premise 部署从 2.12 升级到 2.13,请参阅以下指南:

要在基于 operator 的部署中升级 APIcast,请参阅 APIcast 升级指南中列出的步骤。

使开源包含更多

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看我们的 CTO Chris Wright 信息

第 1 章 3scale 基于 Operator 的升级指南:从 2.12 升级到 2.13

注意
  • 3scale 2.13.1 引入了对 Red Hat OpenShift Container Platform (OCP) 4.12 的支持。
  • 在升级到 OCP 4.12 之前,您必须升级到 3scale 2.13.1。

在基于 operator 的安装中,将 Red Hat 3scale API Management 从 2.12 升级到 2.13,以在 OpenShift 4.x 上管理 3scale。

要自动获得 3scale 的微版本,请确保自动更新已经启动。要查看这一点,请参阅配置微版本自动化应用程序

重要

要了解所需的条件和程序,请务必先阅读整个升级指南,然后再应用列出的步骤。升级过程会破坏服务的调配,直到过程完成为止。因为这个过程需要涉及到系统中断,请确保计划有一个维护窗口进行。

注意

要在升级过程中扩展或缩减副本,请使用 3scale Reconciliation 部分中记录的字段。

1.1. 执行升级的先决条件

本节介绍了在基于 Operator 的安装中,将 3scale 从 2.12 升级到 2.13 所需的配置。

  • 具有管理员访问权限的 OpenShift Container Platform (OCP) 4.8、4.9、4.10 或 4.11 集群。
  • 3scale 2.12 以前通过 3scale Operator 部署。
  • 确保正在使用 threescale-2.12 频道的最新 CSV。检查它:

    • 如果订阅的批准设置是 automatic ,您应该已位于该频道的最新 CSV 版本。
    • 如果订阅的批准设置是 manual,请确保您批准所有待处理的 InstallPlans 并具有最新的 CSV 版本。
    • 请记住,如果有一个待处理的安装计划,可能还有更多待处理的安装计划,只有在安装了现有待定计划后才会显示这些计划。

1.2. 在基于 operator 的安装中从 2.12 升级到 2.13

在基于 operator 的部署中,将 3scale 从 2.12 升级到 2.13:

  1. 使用具有管理员特权的帐户登录 OCP 控制台。
  2. 选择部署了 3scale-operator 的项目。
  3. Operators > Installed Operators
  4. 选择 Red Hat Integration - 3scale > Subscription > Channel
  5. 选择 threescale-2.13 并保存更改,以编辑订阅的频道。

    这将开始升级过程。

  6. 查询项目中 pod 的状态,直到您看到所有新版本都在运行并就绪且没有错误:

    $ oc get pods -n <3scale_namespace>
    注意
    • pod 在升级过程中可能会出现临时错误。
    • 升级 pod 所需的时间可能从 5 到 10 分钟。
  7. 新 pod 版本运行后,通过登录 3scale 管理门户并检查它是否按预期工作,确认升级是否成功。
  8. 运行以下命令,检查 APIManager 对象的状态并获取 YAML 内容。<myapimanager> 代表 APIManager 的名称:

    $ oc get apimanager <myapimanager> -n <3scale_namespace> -o yaml
    • 带有值的新注解应如下所示:

      apps.3scale.net/apimanager-threescale-version: "2.13"
      apps.3scale.net/threescale-operator-version: "0.10.0"

执行所有步骤后,基于 Operator 的部署中的 3scale 从 2.12 升级到 2.13 已完成。

第 2 章 基于 APIcast operator 的升级指南:从 2.12 升级到 2.13

在基于 Operator 的安装中,将 APIcast 从 2.12 升级到 2.13,可帮助您使用 APIcast API 网关将您的内部和外部 API 服务与 3scale 集成。

重要

要了解所需的条件和程序,请务必先阅读整个升级指南,然后再应用列出的步骤。升级过程会破坏服务的调配,直到过程完成为止。因为这个过程需要涉及到系统中断,请确保计划有一个维护窗口进行。

2.1. 执行升级的先决条件

要在基于 operator 的安装过程中执行 APIcast 从 2.12 升级到 2.13,需要满足以下先决条件:

  • 具有管理员访问权限的 OpenShift Container Platform (OCP) 4.8、4.9、4.10 或 4.11 集群。
  • APIcast 2.12 之前通过 APIcast operator 部署。
  • 确保正在使用 threescale-2.12 频道的最新 CSV。检查它:

    • 如果订阅的批准设置是 automatic ,您应该已位于该频道的最新 CSV 版本。
    • 如果订阅的批准设置是 manual,请确保您批准所有待处理的 InstallPlans 并具有最新的 CSV 版本。
    • 请记住,如果有一个待处理的安装计划,可能还有更多待处理的安装计划,只有在安装了现有待定计划后才会显示这些计划。

2.2. 在基于 Operator 的安装中,将 APIcast 从 2.12 升级到 2.13

在基于 Operator 的安装中,将 APIcast 从 2.12 升级到 2.13,以便 APIcast 可以在 3scale 安装中作为 API 网关运行。

流程

  1. 使用具有管理员特权的帐户登录 OCP 控制台。
  2. 选择部署了 APIcast Operator 的项目。
  3. Operators > Installed Operators
  4. Subscription > Channel 中,选择 Red Hat Integration - 3scale APIcast gateway
  5. 选择 threescale-2.13 频道并保存更改,以编辑订阅的频道。

    这将开始升级过程。

  6. 查询项目中 pod 的状态,直到您看到所有新版本都在运行并就绪且没有错误:

    $ oc get pods -n <apicast_namespace>
    注意
    • pod 在升级过程中可能会出现临时错误。
    • 升级 pod 所需的时间可能从 5 到 10 分钟。
  7. 运行以下命令,检查 APIcast 对象的状态,并获取 YAML 内容:

    $ oc get apicast <myapicast> -n <apicast_namespace> -o yaml

执行所有列出的步骤后,基于 operator 的部署中的 APIcast 从 2.12 升级到 2.13 现已完成。

法律通告

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.