更新


Red Hat build of MicroShift 4.14

更新 MicroShift 集群

Red Hat OpenShift Documentation Team

摘要

本文档提供有关更新或升级 MicroShift 集群的说明。

第 1 章 关于红帽构建的 MicroShift 更新

从正式发布版本 4.14 开始,红帽构建的 MicroShift 支持升级。支持的升级包括那些从一个次版本升级到下一个次版本,例如从 4.14 升级到 4.15。补丁更新也支持从 z-stream 升级到 z-stream,如 4.14.1 到 4.14.2。

1.1. 了解 MicroShift 更新

rpm-ostree 边缘部署主机和非OSTree 主机上均支持红帽 MicroShift 更新。您可以使用以下方法完成更新:

  • 将最新版本的 MicroShift 嵌入到新的 rpm-ostree 系统镜像中,如 Red Hat Enterprise Linux for Edge (RHEL for Edge)。请参阅 * 在 OSTree 系统中应用更新
  • 在非 OSTree 系统中手动更新 RPM,如 Red Hat Enterprise Linux (RHEL)。请参阅使用 RPM 手动应用更新
注意

只有 rpm-ostree 更新包括自动回滚。

1.1.1. RPM OSTree 更新

使用 RHEL for Edge rpm-ostree 更新路径允许在更新中的任何部分失败时进行自动备份和系统回滚。您必须构建一个新的 rpm-ostree 镜像,并将新的 MicroShift 版本嵌入到该镜像中。rpm-ostree 镜像可以是相同的版本或更新的版本,但 RHEL for Edge 和 MicroShift 的版本必须兼容。

详情请查看以下兼容性表:

Red Hat Device Edge 发行版本兼容性列表

Red Hat Device Edge 的两个产品作为设备边缘计算的单一解决方案一起工作。要成功对产品配对,请为每个列表使用验证的版本:

Expand

RHEL for Edge 版本

MicroShift 版本

MicroShift 发行版本状态

MicroShift 支持的更新

9.2, 9.3

4.14

正式发布

4.14.0→4.14.z and 4.14→4.15

9.2

4.13

技术预览

None

8.7

4.12

开发者预览

None

1.1.2. 手动 RPM 更新

您可以使用手动 RPM 更新路径替换 MicroShift 的现有版本。RHEL 和 MicroShift 的版本必须兼容。确保系统健康状况和完成额外的系统备份是手动过程。

1.2. 检查版本更新路径

在尝试更新 Red Hat Device Edge 组件前,请确定已安装哪个 MicroShift 和 RHEL for Edge 或 RHEL。规划您要使用的每个版本。

红帽 MicroShift 更新路径的构建

  • 在 RHEL for Edge 9.2 或 9.3 上正式发布版本 4.14 到 4.14.z
  • 在 RHEL 9.2 或 9.3 上正式发布版本 4.14 到 4.14.z

只要两个版本都兼容,您可以使用或不更新 MicroShift 的红帽构建,您可以使用或不更新 Red Hat Enterprise Linux for Edge (RHEL)或 Red Hat Enterprise Linux (RHEL)更新 Red Hat Enterprise Linux for Edge (RHEL)或 Red Hat Enterprise Linux (RHEL)。详情请查看下表:

Red Hat Device Edge 发行版本兼容性列表

Red Hat Device Edge 的两个产品作为设备边缘计算的单一解决方案一起工作。要成功对产品配对,请为每个列表使用验证的版本:

Expand

RHEL for Edge 版本

MicroShift 版本

MicroShift 发行版本状态

MicroShift 支持的更新

9.2, 9.3

4.14

正式发布

4.14.0→4.14.z and 4.14→4.15

9.2

4.13

技术预览

None

8.7

4.12

开发者预览

None

红帽 MicroShift 更新路径的构建

  • 在 RHEL for Edge 9.2 或 9.3 上正式发布版本 4.14.0 到 4.14.z
  • 在 RHEL 9.2 或 9.3 上正式发布版本 4.14.0 到 4.14.z
重要

MicroShift 从一个次版本更新到下一个次版本必须按顺序更新。例如,您无法从 4.14 升级到 4.16。您必须将 4.14 更新至 4.15。

2.1. 独立 MicroShift 更新

您可以在不重新安装您创建的应用程序的情况下更新 MicroShift。RHEL 或 RHEL for Edge 更新不需要更新 MicroShift,只要现有操作系统与您要使用的 MicroShift 的新版本兼容。

红帽构建的 MicroShift 作为原位更新运行,不需要删除之前的版本。除了应用程序通常正常工作所需的数据外,也不需要进行数据备份。

警告

在受支持的 Red Hat Device Edge 配置中保留组件版本可能需要同时更新 MicroShift 和 RHEL。确保您的 RHEL 版本与您要升级到的 MicroShift 版本兼容,特别是在两个次版本间更新 MicroShift 时。否则,您可以创建不支持的配置、破坏集群或两者。如需更多信息,请参阅 Red Hat Device Edge 发行版本兼容性列表

2.1.1. RPM-OSTree 更新

您可以通过构建包含新版本的 MicroShift 的新镜像,在 rpm-ostree 系统上更新 MicroShift,如 RHEL for Edge。确保您要使用的操作系统版本与您升级到的 MicroShift 的新版本兼容。

RHEL for Edge 更新路径中提供以下功能:

  • 如果更新失败,系统会自动回滚到以前的健康系统状态。
  • 不需要重新安装应用程序。
  • 您可以使用此更新类型在不更新 MicroShift 的情况下更新应用程序。
  • 您构建的镜像可以根据需要包含其他更新。

要在 RHEL for Edge 镜像中嵌入一个 MicroShift 更新,请使用以下文档中的流程:

要了解有关 Greenboot 的更多信息,请参阅以下文档:

2.1.2. 手动 RPM 更新

您可以通过下载和更新 RPM,在非 OSTree 系统中手动更新 MicroShift,如 Red Hat Enterprise Linux (RHEL)。要完成这个更新类型,请使用订阅管理器访问包含新 RPM 的存储库。要开始手动 RPM 更新,请使用以下文档中的流程:

2.2. 独立 RHEL for Edge 更新

您可以在不更新 MicroShift 的情况下更新 RHEL for Edge 或 RHEL,这取决于两个版本兼容的情况。在开始更新前,请检查 compatibilities。使用特定于您的更新路径的 RHEL for Edge 文档。

2.3. 同步 MicroShift 和操作系统更新

您可以在版本兼容的情况下同时更新 RHEL for Edge 或 RHEL 并更新 MicroShift。在开始更新前检查兼容性。首先,使用特定于您的更新路径的 RHEL for Edge 文档来计划和更新操作系统。然后,使用特定于您的更新路径的 MicroShift 更新类型。

rpm-ostree 系统上更新 MicroShift 的红帽构建,如 Red Hat Enterprise Linux for Edge (RHEL for Edge)需要构建一个新的操作系统镜像,其中包含红帽构建的 MicroShift 的新版本。在嵌入了红帽构建的 MicroShift 的 rpm-ostree 镜像后,指示您的系统引导到那个操作系统镜像。

对于补丁和次版本更新,这个过程是相同的。例如,使用相同的步骤从 4.14.0 升级到 4.14.1,或者从 4.14 升级到 4.15。

Red Hat Device Edge 发行版本兼容性列表

Red Hat Device Edge 的两个产品作为设备边缘计算的单一解决方案一起工作。要成功对产品配对,请为每个列表使用验证的版本:

Expand

RHEL for Edge 版本

MicroShift 版本

MicroShift 发行版本状态

MicroShift 支持的更新

9.2, 9.3

4.14

正式发布

4.14.0→4.14.z and 4.14→4.15

9.2

4.13

技术预览

None

8.7

4.12

开发者预览

None

注意

不支持降级。以下流程只适用于升级。

3.1. 在 OSTree 系统上应用更新

要在 rpm-ostree 系统上更新 MicroShift,如 Red Hat Enterprise Linux for Edge (RHEL for Edge),请在新的操作系统镜像中嵌入 MicroShift 的新版本。您使用的步骤取决于您的现有部署是如何设置的。以下流程概述了您可以执行的一般步骤,以及 RHEL for Edge 文档的链接。RHEL for Edge 文档包括了构建更新的操作系统镜像的特定详情的资源。使用这个更新类型,备份和系统回滚是自动的。

注意

您还可以使用此工作流更新在 MicroShift 集群中运行的应用程序。在开始更新前,请确保应用程序和 MicroShift 和 RHEL for Edge 的相邻版本之间的兼容性。

先决条件

  • 满足安装 MicroShift 的系统要求。
  • 您有访问主机的 root 用户。
  • MicroShift 的版本与您准备使用的 RHEL for Edge 镜像兼容。
注意

您不能使用此流程降级 MicroShift。不支持降级。

流程

  1. 运行以下命令,创建一个镜像构建器配置文件来添加拉取 MicroShift RPM 所需的 rhocp-4.14 RPM 存储库源:

    $ cat > rhocp-4.14.toml <<EOF
    id = "rhocp-4.14"
    name = "Red Hat OpenShift Container Platform 4.14 for RHEL 9"
    type = "yum-baseurl"
    url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/rhocp/4.14/os"
    check_gpg = true
    check_ssl = true
    system = false
    rhsm = true
    EOF
  2. 运行以下命令,将更新 RPM 源添加到镜像构建器中:

    $ sudo composer-cli sources add rhocp-4.14.toml
  3. 构建包含 MicroShift 的新版本的 RHEL for Edge 的新镜像。要确定所需的步骤,请使用以下文档:

  4. 更新主机以使用 RHEL for Edge 的新镜像。要确定所需的步骤,请使用以下文档:

  5. 运行以下命令重启主机以应用更新:

    $ sudo systemctl reboot

第 4 章 关于手动更新红帽 MicroShift RPM 构建

为非OSTree 系统(如 Red Hat Enterprise Linux (RHEL))更新红帽 MicroShift 需要下载,然后更新 RPM。对于补丁版本,如 4.14.1 到 4.14.2,请下载和更新 RPM。对于次版本更新,请添加使用订阅管理器启用更新存储库的步骤。

重要

MicroShift 更新会按顺序从一个次版本到下一个次版本被支持。例如,您必须将 4.14 更新至 4.15。

对于使用补丁更新或次版本更新进行升级,您可以根据需要备份应用程序数据,并将数据副本移到安全位置。

4.1. 使用 RPM 应用补丁更新

在非 rpm-ostree 系统上更新 MicroShift,如 Red Hat Enterprise Linux (RHEL)需要下载,然后更新 RPM。补丁更新不需要系统重启。例如,按照以下流程从 4.14.0 升级到 4.14.1。

先决条件

  • 满足安装 MicroShift 的系统要求。
  • 您有访问主机的 root 用户。
  • 您兼容的 MicroShift 版本与升级到您要使用的版本兼容。
  • 您已确认主机操作系统是否与您要准备安装的 MicroShift 版本兼容。
  • 您已完成系统备份。
注意

您不能使用此流程降级 MicroShift。不支持降级。

流程

  • 运行以下命令来更新 MicroShift RPM:

    $ sudo dnf update microshift
注意

系统健康检查在此更新类型上运行,但不执行任何操作。如果更新失败,则会出现错误消息,其中包含用于检查日志的指令。

4.2. 使用 RPM 应用次版本更新

在非 rpm-ostree 系统中更新 MicroShift 次版本,如 Red Hat Enterprise Linux (RHEL)需要下载,然后更新 RPM。例如,按照以下流程从 4.14 更新至 4.15。

重要

您只能按顺序将 MicroShift 从一个版本更新至下一个版本。不支持跳过次版本。例如,必须将 4.14 更新至 4.15。

先决条件

  • 满足安装 MicroShift 的系统要求。
  • 您有访问主机的 root 用户。
  • 您兼容的 MicroShift 版本与升级到您要使用的版本兼容。
  • 您已确认主机操作系统是否与您要准备安装的 MicroShift 版本兼容。
  • 您已完成系统备份。
注意

您不能使用此流程降级 MicroShift。不支持降级。

流程

  1. 在所有生命周期中,运行以下命令来为您要升级到的发行版本启用仓库:

    $ sudo subscription-manager repos \
        --enable rhocp-4.14-for-rhel-9-$(uname -m)-rpms \
        --enable fast-datapath-for-rhel-9-$(uname -m)-rpms
  2. 对于扩展支持(EUS)版本,请运行以下命令启用 EUS 软件仓库:

    $ sudo subscription-manager repos \
        --enable rhel-9-for-$(uname -m)-appstream-eus-rpms \
        --enable rhel-9-for-$(uname -m)-baseos-eus-rpms
  3. 使用以下命令锁定操作系统版本,以避免将来的更新到不受支持的配置中:

    $ sudo subscription-manager release --set=9.2
  4. 运行以下命令来更新 MicroShift RPM:

    $ sudo dnf update microshift
  5. 运行以下命令重启主机以应用更新:

    $ sudo systemctl reboot
注意

系统健康检查在此更新类型上运行,但不执行任何操作。如果更新失败,则会出现错误消息,其中包含用于检查日志的指令。

验证

  1. 运行以下命令,检查健康检查是否在成功引导时退出:

    $ sudo systemctl status greenboot-healthcheck
  2. 运行以下命令检查健康检查日志:

    $ sudo journalctl -u greenboot-healthcheck

法律通告

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat
返回顶部