23.3. 滚动不兼容的更改
以下配置更改会返回 "Rolling Update is not possible" 结果代码。
23.3.1. 功能 复制链接链接已复制到粘贴板!
23.3.1.1. recreate always 复制链接链接已复制到粘贴板!
启用或禁用以下功能需要重新创建更新:
| 功能 | 描述 |
|---|---|
| multi-site:v1 | 多站点支持 |
| persistent-user-sessions:v1 | 重启和升级后持久的在线用户会话 |
23.3.1.2. 在功能版本更改时重新创建 复制链接链接已复制到粘贴板!
更改以下功能版本会触发重新创建的更新:
| 功能 | 描述 |
|---|---|
| login:v1 | 传统登录主题 |
| login:v2 | 新的登录主题 |
| passkeys-conditional-ui-authenticator:v1 | Passkeys 条件 UI 验证器 |
23.3.2. 配置选项 复制链接链接已复制到粘贴板!
更改以下 CLI 选项之一的值会触发重新创建更新:
| 选项 | rationale |
|---|---|
|
|
|
|
| 更改配置文件可能会导致缓存或传输配置不兼容,从而导致集群无法按预期形成。 |
|
| 更改堆栈会导致集群在滚动更新过程中不会形成,并导致数据丢失。 |
|
| 启用/禁用 TLS 将导致集群在滚动更新过程中不会形成,并导致数据丢失。 |
|
| 连接到新的远程缓存将导致之前缓存的数据丢失。 |
|
| 连接到新的远程缓存将导致之前缓存的数据丢失。 |
红帽构建的 Keycloak 不会验证通过-cache- config-file 提供的缓存 配置文件内容的更改。如果更改了此文件,您需要检查并测试您的更改,以确保使用新配置的节点可以使用运行旧配置的节点组成集群。如果无法建立集群,您应该在迁移到新配置前先关闭 Red Hat build of Keycloak 的 Keycloak。
| 选项 | rationale |
|---|---|
|
| 迁移到新的数据库供应商应应用到所有群集成员,以确保数据一致性。 |
|
| 迁移到新数据库架构应当应用到所有群集成员,以确保数据一致性。 |
|
| 迁移到新数据库名称应当应用到所有群集成员,以确保数据一致性。 |
|
| 所有群集成员都应连接到同一数据库,以确保数据一致性。 |
|
| 所有群集成员都应连接到同一数据库,以确保数据一致性。 |
Red Hat build of Keycloak 允许推出对 -db-url 选项的更改,以便于更改 JDBC 属性。当更新这个值时,在更新这个值时应小心,因为更改主机、端口或数据库名称可能会导致不同的集群成员连接到不同的数据库,从而导致数据一致性问题。