第 1 章 3scale API 管理基于 operator 的升级指南:从 2.14 升级到 2.15
在基于 operator 的安装中,将 Red Hat 3scale API Management 从 2.15 升级到 2.16,以在 OpenShift 4.x 上管理 3scale。
要自动获得 3scale 的微版本,请确保自动更新已经启动。如果您使用 Oracle 外部数据库,请不要设置自动更新。要检查这一点,请参阅配置微版本的自动应用程序。
为了了解所需的条件和程序,请在应用列出的步骤前阅读整个升级指南。升级过程会破坏服务的调配,直到过程完成为止。因为这个过程需要涉及到系统中断,请确保计划有一个维护窗口进行。
1.1. 执行升级的先决条件 复制链接链接已复制到粘贴板!
本节论述了在基于 Operator 的安装中,将 3scale 从 2.15 升级到 2.16 所需的配置。
- 具有管理员访问权限的 OpenShift Container Platform (OCP) 4.12、4.13、4.14、4.15、4.16 或 4.17 集群。确保您的 OCP 环境至少升级到 4.12 版本,这是进行 3scale 更新的最低要求。
- 3scale 2.15 之前通过 3scale operator 部署。
确保正在使用
threescale-2.15频道的最新 CSV。检查它:- 如果订阅的批准设置 是自动的,您应该已处于该频道的最新 CSV 版本。
- 如果订阅的批准设置是 manual,请确保批准所有待处理的 InstallPlans,并具有最新的 CSV 版本。
- 请记住,如果有一个待处理的安装计划,可能还有更多待处理的安装计划,只有在安装了现有待定计划后才会显示这些计划。
1.1.1. 3scale API Management 2.15 pre-flight 检查 复制链接链接已复制到粘贴板!
- 如果没有升级数据库,3scale 实例不会升级到 2.16。
- 您可以在运行 3scale 2.16 operator 时或不升级数据库。如果 Operator 正在运行,它会每 10 分钟检查数据库版本,并自动触发升级过程。如果 Operator 在升级过程中没有运行,请扩展它。您必须这样做才能验证要求并继续安装。
在通过操作器安装 3scale 2.16 之前,请确保您的数据库组件满足所需的最低版本。这个 pre-flight 检查对于避免在升级过程中破坏 3scale 实例至关重要。
1.1.1.1. 组件和最低版本要求 复制链接链接已复制到粘贴板!
- Oracle 数据库不会被检查。
- 不选中带有 Oracle 的系统数据库。
- 没有检查带有外部数据库的 zync。
确保以下组件位于或超过指定版本:
system-app 组件:
- MySQL: 8.0.0
- PostgreSQL: 10.0.0
后端组件:
- Redis: 6.2 (需要两个实例)
版本验证
验证 MySQL 版本:
mysql --version
$ mysql --versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow 验证 PostgreSQL 版本:
psql --version
$ psql --versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow 验证 Redis 版本:
redis-server --version
$ redis-server --versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow
1.1.1.2. 升级数据库不满足要求 复制链接链接已复制到粘贴板!
如果您的数据库版本没有满足最低要求,请按照以下步骤执行:
- 无论数据库版本是什么,都安装了 2.16 运算符。
升级数据库:
- 升级 MySQL、PostgreSQL 或 Redis,以满足最低所需的版本。
- 注意: 遵循每个数据库的升级程序的官方文档。
恢复 2.16 升级:
- 当数据库升级后,3scale 2.16 operator 会检测新版本。
- 3scale 2.16 的升级过程将自动进行。
通过遵循这些预动态检查并确保数据库组件处于最新状态,您可以过渡到 3scale 2.16。