23.4. 补丁发行版本的滚动更新
警告
这个行为目前处于 preview 模式,不建议在生产环境中使用。
可以配置红帽构建的 Keycloak 兼容性命令,以便在升级到同一 major.minor 发行流中的较新的补丁版本时进行滚动更新。
要启用这个兼容性检查命令的行为,请启用功能 rolling-updates:v2,如下例所示。
bin/kc.[sh|bat] update-compatibility check --file=/path/to/file.json --features=rolling-updates:v2
bin/kc.[sh|bat] update-compatibility check --file=/path/to/file.json --features=rolling-updates:v2
请注意,使用 metadata 命令生成元数据时不需要更改。
推荐的配置:
- 在您的 loadbalancer 中启用粘性会话,以避免用户在不同版本的 Keycloak 之间购买,因为这可能导致用户在升级进行时多次刷新帐户控制台和 Admin UI。
在滚动更新过程中支持的功能:
- 用户可以登录并注销 OpenID Connect 客户端。
- OpenID Connect 客户端可以执行所有操作,例如刷新令牌并查询用户信息端点。
已知限制:
- 如果在补丁版本中更改了 Account Console 或 Admin UI,并且用户在升级过程中打开 Account Console 或 Admin UI,用户可能会看到错误消息,并在升级后通过浏览器导航时重新加载应用程序。
- 如果红帽构建的 Keycloak 的两个补丁版本使用不同的嵌入式 Infinispan 版本,则不会执行红帽构建的 Keycloak 滚动更新。