23.2.2. 检查元数据


这个命令检查上一命令生成的元数据,并将其与当前配置和红帽构建的 Keycloak 版本进行比较。如果您要升级到新的红帽构建的 Keycloak 版本,则必须使用新版本执行这个命令。

检查之前部署的元数据。

bin/kc.[sh|bat] update-compatibility check --file=/path/to/file.json

警告
  • 在运行此命令时,请确保包含通过环境变量或 CLI 参数设置的所有配置选项。
  • 验证是否使用正确的红帽构建的 Keycloak 版本。

无法满足这些要求会导致结果不正确。

命令将结果输出到控制台。例如,如果可能滚动更新,它会显示:

滚动更新可能消息

[OK] Rolling Update is available.

如果没有进行滚动更新,命令会提供有关不兼容的详细信息:

滚动更新不可能的消息

[keycloak] Rolling Update is not available. 'keycloak.version' is incompatible: 26.2.0 -> 26.2.1 
1

1
在本例中,Keycloak 版本 26.2.0 与版本 26.2.1 不兼容,且无法进行滚动更新。

命令退出代码

使用命令的退出代码决定自动化管道中的更新类型:

Expand
退出代码描述

0

可以滚动更新。

1

发生意外错误(如元数据文件缺失或损坏)。

2

无效的 CLI 选项。

3

无法进行滚动更新。在应用新配置前,必须关闭部署。

4

无法进行滚动更新。禁用 功能 滚动更新

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

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

让开源更具包容性

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

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部