升级

NOTE

本文档介绍 Alauda Application Services Identity Management E1 的升级路径原则和支持的版本兼容性。

兼容性矩阵

下表列出了 Alauda Application Services Identity Management E1 及其关键组件支持的版本。有关特定版本的变更、新功能和弃用项,请参阅 Release Notes。

Release上游 Keycloak™Kubernetes
26.7.426.7.41.25+

先决条件

开始升级前,请确保满足以下条件:

  1. 版本兼容性:当前版本位于支持的升级路径中。
  2. 实例运行状况:所有 Keycloak 实例均处于 Ready 状态。
  3. 数据库备份:继续操作前创建 PostgreSQL 数据库的备份。
  4. 资源可用性:集群具有足够的资源来支持升级过程。

检查所有 Keycloak 实例的运行状况:

kubectl get keycloak -A -o custom-columns="NAME:.metadata.name,NAMESPACE:.metadata.namespace,READY:.status.conditions[?(@.type=='Ready')].status"

升级路径指南

连续升级(推荐)

逐步通过连续版本进行升级,以确保兼容性。

补丁级别升级

同一 minor 版本内的补丁版本之间完全兼容,可以直接执行升级,无需额外的迁移步骤。

升级后无法回滚

Operator 升级并应用数据库架构迁移后,不支持降级到之前的 Keycloak 版本。数据库架构会在升级过程中更新,且不向后兼容。升级前请务必备份 PostgreSQL 数据库。

升级操作步骤

Web 控制台
CLI
  1. 登录平台并转到 平台管理 页面。
  2. 在左侧导航栏中,选择 Marketplace > 集群插件。
  3. 找到 Alauda Application Services Identity Management E1,然后点击 升级。
  4. 选择目标版本并确认升级。
  5. 监控 Operator Pod 状态,直到其恢复为 Running。
  6. 验证所有 Keycloak 实例是否恢复为 Ready 状态。

升级策略

Alauda Application Services Identity Management E1 根据 Operator subscription 中配置的升级策略执行升级:

  • 自动:当检测到 channel 中有新的 Operator 版本时,立即触发自动升级。不建议用于生产环境——自动升级会跳过对 release notes 和数据库迁移变更的人工审核。
  • 手动:启动升级过程前需要手动批准。这是生产环境推荐使用的策略。

Keycloak™ 是 The Linux Foundation 的商标。Alauda 是一家独立供应商。本产品与 The Linux Foundation 没有任何关联,也未获得其认可或赞助。所有商标均归其各自所有者所有,此处仅用于标识目的。