23.3. 滚动不兼容的更改


以下配置更改会返回 "Rolling Update is not possible" 结果代码。

23.3.1. 功能

23.3.1.1. recreate always

启用或禁用以下功能需要重新创建更新:

Expand
功能描述

multi-site:v1

多站点支持

persistent-user-sessions:v1

重启和升级后持久的在线用户会话

23.3.1.2. 在功能版本更改时重新创建

更改以下功能版本会触发重新创建的更新:

Expand
功能描述

login:v1

传统登录主题

login:v2

新的登录主题

passkeys-conditional-ui-authenticator:v1

Passkeys 条件 UI 验证器

23.3.2. 配置选项

更改以下 CLI 选项之一的值会触发重新创建更新:

Expand
表 23.1. Cache
选项rationale

--cache

ispnlocal 配置是相互排斥的,从一个配置改为另一个配置会导致数据丢失。

--cache-config-file

更改配置文件可能会导致缓存或传输配置不兼容,从而导致集群无法按预期形成。

--cache-stack

更改堆栈会导致集群在滚动更新过程中不会形成,并导致数据丢失。

--cache-embedded-mtls-enabled

启用/禁用 TLS 将导致集群在滚动更新过程中不会形成,并导致数据丢失。

--cache-remote-host

连接到新的远程缓存将导致之前缓存的数据丢失。

--cache-remote-port

连接到新的远程缓存将导致之前缓存的数据丢失。

警告

红帽构建的 Keycloak 不会验证通过-cache- config-file 提供的缓存 配置文件内容的更改。如果更改了此文件,您需要检查并测试您的更改,以确保使用新配置的节点可以使用运行旧配置的节点组成集群。如果无法建立集群,您应该在迁移到新配置前先关闭 Red Hat build of Keycloak 的 Keycloak。

Expand
表 23.2. 数据库
选项rationale

--db

迁移到新的数据库供应商应应用到所有群集成员,以确保数据一致性。

--db-schema

迁移到新数据库架构应当应用到所有群集成员,以确保数据一致性。

--db-url-database

迁移到新数据库名称应当应用到所有群集成员,以确保数据一致性。

--db-url-host

所有群集成员都应连接到同一数据库,以确保数据一致性。

--db-url-port

所有群集成员都应连接到同一数据库,以确保数据一致性。

警告

Red Hat build of Keycloak 允许推出对 -db-url 选项的更改,以便于更改 JDBC 属性。当更新这个值时,在更新这个值时应小心,因为更改主机、端口或数据库名称可能会导致不同的集群成员连接到不同的数据库,从而导致数据一致性问题。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat