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
- 在本例中,Keycloak 版本
26.2.0与版本26.2.1不兼容,且无法进行滚动更新。
命令退出代码
使用命令的退出代码决定自动化管道中的更新类型:
| 退出代码 | 描述 |
|---|---|
|
| 可以滚动更新。 |
|
| 发生意外错误(如元数据文件缺失或损坏)。 |
|
| 无效的 CLI 选项。 |
|
| 无法进行滚动更新。在应用新配置前,必须关闭部署。 |
|
|
无法进行滚动更新。禁用 |