升级
NOTE
本文档提供了 Alauda Build of Keycloak 的升级路径原则及支持的版本兼容性。
兼容性矩阵
下表列出了 Alauda Build of Keycloak 及其关键组件支持的版本。有关特定版本的变更、新功能和废弃信息，请参阅 Release Notes。
先决条件
在开始升级之前，请确保以下条件：
- 版本兼容性：当前版本处于支持的升级路径范围内。
- 实例健康状态：所有 Keycloak 实例均处于
Ready状态。 - 数据库备份：升级前请备份 PostgreSQL 数据库。
- 资源可用性：集群有足够资源支持升级过程。
检查所有 Keycloak 实例的健康状态：
升级路径指南
连续升级（推荐）
逐版本依次升级，确保兼容性。
补丁级别升级
同一小版本内的补丁版本升级完全兼容，可直接升级，无需额外迁移步骤。
升级后不可回滚
Operator 升级并应用数据库架构迁移后，不支持降级回先前的 Keycloak 版本。升级过程中数据库架构会更新，且不向后兼容。升级前务必备份 PostgreSQL 数据库。
升级操作步骤
- 登录平台，进入 平台管理 页面。
- 在左侧导航栏选择 Marketplace > 集群插件。
- 找到 Alauda Build of Keycloak 并点击 升级。
- 选择目标版本并确认升级。
- 监控 Operator Pod 状态，直到恢复为
Running。 - 确认所有 Keycloak 实例恢复到
Ready状态。
升级策略
Alauda Build of Keycloak 根据 Operator 订阅中配置的升级策略执行升级：
- 自动：检测到通道中有新 Operator 版本时立即触发自动升级。不推荐用于生产环境 —— 自动升级绕过了对 release notes 和数据库迁移变更的人工审核。
- 手动：需人工确认后才开始升级流程。此策略为生产环境推荐使用。