红帽全球峰会第 5 章 对更新进行故障排除
要对 MicroShift 更新进行故障排除，请使用以下指南。
5.1. MicroShift 更新故障排除
在某些情况下，MicroShift 可能无法更新。在这些事件中，了解设备类型以及如何对它们进行故障排除会很有帮助。
5.1.1. MicroShift 版本序列阻止更新路径
MicroShift 的非 EUS 版本需要串行更新。例如，如果您试图直接从 MicroShift 4.15.5 更新至 4.17.1，则更新会失败。您必须首先将 4.15.5 更新至 4.16.z，然后您可以从 4.16.z 更新至 4.17.0。
5.1.2. 更新路径会受版本不兼容阻止
如果 MicroShift 更新与 Red Hat Enterprise Linux for Edge 版本(RHEL for Edge)或 Red Hat Enterprise Linux (RHEL)版本不兼容，则 RPM 依赖项错误结果。
5.1.2.1. 兼容性表
检查以下兼容性表：
Red Hat Device Edge 发行版本兼容性列表
Red Hat Enterprise Linux (RHEL)和 MicroShift 作为一个设备边缘计算的单一解决方案一起工作。您可以单独更新每个组件，但产品版本必须兼容。支持的 Red Hat Device Edge 配置会为每个版本一起使用验证的版本，如下表所示：
| RHEL 版本 | MicroShift 版本 | 支持的 MicroShift 版本 |
|---|---|---|
| 9.4 | 4.18 | 4.18.0 → 4.18.z |
| 9.4 | 4.17 | 4.17.1 → 4.17.z, 4.17 → 4.18 |
| 9.4 | 4.16 |
4.16.0 |
| 9.2, 9.3 | 4.15 |
4.15.0 |
| 9.2, 9.3 | 4.14 |
4.14.0 |
5.1.2.2. 版本兼容性
检查以下更新路径：
红帽 MicroShift 更新路径的构建
- RHEL 9.4 上正式发布版本 4.18.0 到 4.18.z
- RHEL 9.4 上正式发布版本 4.17.1 到 4.17.z
- RHEL 9.4 上正式发布版本 4.15.0 从 RHEL 9.2 升级到 4.16.0
- RHEL 9.4 上正式发布版本 4.14.0 从 RHEL 9.2 到 4.15.0
5.1.3. ostree 更新失败
如果您在 OSTree 系统中更新，Greenboot 健康检查会自动记录并操作系统健康状况。Greenboot 可以表示系统回滚失败。如果更新失败，但 Greenboot 没有完成系统回滚，您可以使用遵循此内容的"Additional resources"部分中的 RHEL for Edge 文档进行故障排除。
- 手动检查 Greenboot 日志
运行以下命令手动检查 Greenboot 日志以验证系统健康状况：
$ sudo systemctl restart --no-block greenboot-healthcheck && sudo journalctl -fu greenboot-healthcheck
5.1.4. 手动 RPM 更新失败
如果您使用非OSTree 系统上的 RPM 更新，则 Greenboot 可以指示更新失败，但健康检查只是信息性。检查系统日志是对手动 RPM 更新失败的故障排除步骤。您可以使用 Greenboot 和 sos 报告 来检查 MicroShift 更新和主机系统。
