Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

更新

Red Hat build of MicroShift 4.16

更新 MicroShift 集群

Red Hat OpenShift Documentation Team

摘要

了解如何更新红帽构建的 MicroShift 集群。

第 1 章 关于红帽构建的 MicroShift 更新
复制链接

从正式发布版本 4.14 开始，红帽构建的 MicroShift 支持更新。在 4.16 发行版本中，支持以下更新：

  • 连续最多两个次版本，例如从 4.14 到 4.16。
  • 一个次版本按顺序到下一个次版本，例如从 4.15 升级到 4.16。
  • 补丁更新也支持从 z-stream 升级到 z-stream，如 4.16.1 到 4.16.2。

1.1. 了解 MicroShift 更新
复制链接

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

注意

只有 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 Enterprise Linux (RHEL)和 MicroShift 可以一起工作，作为设备边缘计算的单一解决方案。您可以单独更新每个组件，但产品版本必须兼容。例如，将 MicroShift 从 4.14 更新至 4.16 需要 {op-system} 更新。如下表所示，Red Hat Device Edge 的支持的配置为每个 Red Hat Device Edge 使用验证的版本：

Expand

RHEL for Edge 版本

MicroShift 版本

MicroShift 发行版本状态

支持的 MicroShift 版本→MicroShift 版本更新

9.4

4.16

正式发布

4.16.0→4.16.z, 4.14→4.16 和 4.15→4.16

9.2, 9.3

4.15

正式发布

4.15.0→4.15.z, 4.14→4.15 和 4.15→4.16

9.2, 9.3

4.14

正式发布

4.14.0→4.14.z, 4.14→4.15 和 4.14→4.16

9.2

4.13

技术预览

None

8.7

4.12

开发者预览

None

1.1.2. 手动 RPM 更新
复制链接

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

重要

确保您的 RHEL 版本与您要更新的 MicroShift 版本兼容，特别是在两个次版本间更新 MicroShift 时。

1.1.3. 检查版本更新路径
复制链接

在更新 MicroShift 或 {op-system} 之前，请确定兼容。规划您要使用的每个版本。

红帽 MicroShift 更新路径的构建

MicroShift 版本 4.16
  • 在 {op-system} 或 RHEL for Edge 9.4 上版本 4.16 到 4.16.z
MicroShift 版本 4.15
  • {op-system} 上的版本 4.15 或 RHEL for Edge 9.2 或 RHEL for Edge 9.2 或 9.3 到 4.16 on {op-system} 或 RHEL for Edge 9.4
  • 在 {op-system} 或 RHEL for Edge 9.2 或 9.3 上版本 4.15 到 4.15.z
MicroShift 版本 4.14
  • {op-system} 或 RHEL for Edge 9.2 或 RHEL for Edge 9.3 上的版本 4.14 在 {op-system} 或 RHEL for Edge 9.4 上
  • 在 {op-system} 或 RHEL for Edge 9.2 或 9.3 上版本 4.14 到 4.15
  • 在 {op-system} 或 RHEL for Edge 9.2 或 9.3 上版本 4.14 到 4.14.z

如果支持版本组合，您可以使用或不更新 MicroShift 版本的 Red Hat Enterprise Linux for Edge (RHEL)镜像或 Red Hat Enterprise Linux (RHEL)更新 Red Hat build。详情请查看下表：

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

Red Hat Enterprise Linux (RHEL)和 MicroShift 可以一起工作，作为设备边缘计算的单一解决方案。您可以单独更新每个组件，但产品版本必须兼容。例如，将 MicroShift 从 4.14 更新至 4.16 需要 {op-system} 更新。如下表所示，Red Hat Device Edge 的支持的配置为每个 Red Hat Device Edge 使用验证的版本：

Expand

RHEL for Edge 版本

MicroShift 版本

MicroShift 发行版本状态

支持的 MicroShift 版本→MicroShift 版本更新

9.4

4.16

正式发布

4.16.0→4.16.z, 4.14→4.16 和 4.15→4.16

9.2, 9.3

4.15

正式发布

4.15.0→4.15.z, 4.14→4.15 和 4.15→4.16

9.2, 9.3

4.14

正式发布

4.14.0→4.14.z, 4.14→4.15 和 4.14→4.16

9.2

4.13

技术预览

None

8.7

4.12

开发者预览

None

2.1. 检查版本更新路径
复制链接

在更新 MicroShift 或 {op-system} 之前，请确定兼容。规划您要使用的每个版本。

红帽 MicroShift 更新路径的构建

MicroShift 版本 4.16
  • 在 {op-system} 或 RHEL for Edge 9.4 上版本 4.16 到 4.16.z
MicroShift 版本 4.15
  • {op-system} 上的版本 4.15 或 RHEL for Edge 9.2 或 RHEL for Edge 9.2 或 9.3 到 4.16 on {op-system} 或 RHEL for Edge 9.4
  • 在 {op-system} 或 RHEL for Edge 9.2 或 9.3 上版本 4.15 到 4.15.z
MicroShift 版本 4.14
  • {op-system} 或 RHEL for Edge 9.2 或 RHEL for Edge 9.3 上的版本 4.14 在 {op-system} 或 RHEL for Edge 9.4 上
  • 在 {op-system} 或 RHEL for Edge 9.2 或 9.3 上版本 4.14 到 4.15
  • 在 {op-system} 或 RHEL for Edge 9.2 或 9.3 上版本 4.14 到 4.14.z
重要

MicroShift 的更新最多支持两个次版本。例如，您可以在一个步骤中从 4.14 升级到 4.16。首先需要将 4.14 更新至 4.15。

2.2. 独立 MicroShift 更新
复制链接

在计划更新 MicroShift 时请考虑以下几点：

  • 您可以在不重新安装应用程序和 Operator 的情况下更新 MicroShift。
  • 如果现有操作系统与您要使用的 MicroShift 的新版本不兼容，则只需要 RHEL 或 RHEL for Edge 更新来更新 MicroShift。
  • MicroShift 作为原位升级运行，不需要删除之前的版本。除了应用程序通常正常工作所需的数据外，也不需要进行数据备份。
警告

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

2.2.1. RPM-OSTree 更新
复制链接

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

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

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

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

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

2.2.2. 手动 RPM 更新
复制链接

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

2.3. 独立 RHEL for Edge 更新
复制链接

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

2.4. 同步 MicroShift 和操作系统更新
复制链接

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

第 3 章 更新 OSTree 系统上的 RPM
复制链接

在 rpm-ostree 系统上更新 MicroShift，如 Red Hat Enterprise Linux for Edge (RHEL for Edge)需要构建一个新的 RHEL for Edge 镜像，其中包含新版本的 MicroShift 以及任何关联的可选 RPM。在嵌入了带有 MicroShift 的 rpm-ostree 镜像后，指示您的系统引导到那个操作系统镜像。

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

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

Red Hat Enterprise Linux (RHEL)和 MicroShift 可以一起工作，作为设备边缘计算的单一解决方案。您可以单独更新每个组件，但产品版本必须兼容。例如，将 MicroShift 从 4.14 更新至 4.16 需要 {op-system} 更新。如下表所示，Red Hat Device Edge 的支持的配置为每个 Red Hat Device Edge 使用验证的版本：

Expand

RHEL for Edge 版本

MicroShift 版本

MicroShift 发行版本状态

支持的 MicroShift 版本→MicroShift 版本更新

9.4

4.16

正式发布

4.16.0→4.16.z, 4.14→4.16 和 4.15→4.16

9.2, 9.3

4.15

正式发布

4.15.0→4.15.z, 4.14→4.15 和 4.15→4.16

9.2, 9.3

4.14

正式发布

4.14.0→4.14.z, 4.14→4.15 和 4.14→4.16

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.16 RPM 存储库源： 

    $ cat > rhocp-4.16.toml <<EOF
id = "rhocp-4.16"
name = "Red Hat OpenShift Container Platform 4.16 for RHEL 9"
type = "yum-baseurl"
url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/rhocp/4.16/os"
check_gpg = true
check_ssl = true
system = false
rhsm = true
EOF
    Copy to Clipboard Toggle word wrap

  2. 运行以下命令，将更新 RPM 源添加到镜像构建器中： 

    $ sudo composer-cli sources add rhocp-4.16.toml
    Copy to Clipboard Toggle word wrap

  3. 构建包含 MicroShift 的新版本的 RHEL for Edge 的新镜像。要确定所需的步骤，请使用以下文档：

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

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

    $ sudo systemctl reboot
    Copy to Clipboard Toggle word wrap

第 4 章 关于手动更新红帽 MicroShift RPM 构建
复制链接

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

重要

MicroShift 更新最多支持两个次版本。例如，您可以在一个步骤中从 4.14 更新至 4.16。首先需要将 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
    Copy to Clipboard Toggle word wrap
注意

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

4.2. 使用 RPM 应用次版本更新
复制链接

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

重要

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

先决条件

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

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

流程

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

    $ sudo subscription-manager repos \
    --enable rhocp-4.16-for-rhel-9-$(uname -m)-rpms \
    --enable fast-datapath-for-rhel-9-$(uname -m)-rpms
    Copy to Clipboard Toggle word wrap

  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
    Copy to Clipboard Toggle word wrap

  3. 使用以下命令锁定操作系统版本，以避免将来的更新到不受支持的配置中： 

    $ sudo subscription-manager release --set=9.4
    Copy to Clipboard Toggle word wrap

  4. 运行以下命令来更新 MicroShift RPM： 

    $ sudo dnf update microshift
    Copy to Clipboard Toggle word wrap

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

    $ sudo systemctl reboot
    Copy to Clipboard Toggle word wrap
注意

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

验证

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

    $ sudo systemctl status greenboot-healthcheck
    Copy to Clipboard Toggle word wrap

  2. 运行以下命令检查健康检查日志： 

    $ sudo journalctl -u greenboot-healthcheck
    Copy to Clipboard Toggle word wrap

第 5 章 列出 RPM 更新软件包内容
复制链接

在安装前，您可以预览 MicroShift RPM 软件包更新的内容。

5.1. 列出 MicroShift RPM 发行软件包的内容
复制链接

要查看 MicroShift 发行版本中包含的镜像，您可以通过下载和解包 RPM 列出 microshift-release-info RPM 的内容。

先决条件

  • 您使用 Red Hat Enterprise Linux (RHEL)或 RPM 软件包管理器的操作系统。
  • 您的 MicroShift 存储库已启用。

流程

  1. 可选：运行以下命令来列出哪些 MicroShift RPM 版本可供下载： 

    $ sudo dnf repoquery microshift-release-info-0:4.16.*
    1
    Copy to Clipboard Toggle word wrap
    1
    将 示例值替换为 您感兴趣的主版本和次发行版本号。

    输出示例

    Updating Subscription Management repositories.
microshift-release-info-0:4.16.0-202406260523.p0.gc5a37df.assembly.4.16.0.el9.noarch
microshift-release-info-0:4.16.1-202406281132.p0.g8babeb9.assembly.4.16.1.el9.noarch
microshift-release-info-0:4.16.10-202408291007.p0.g6e4ee4d.assembly.4.16.10.el9.noarch
microshift-release-info-0:4.16.2-202407040825.p0.g2e0407e.assembly.4.16.2.el9.noarch
microshift-release-info-0:4.16.3-202407111123.p0.ge4206d3.assembly.4.16.3.el9.noarch
microshift-release-info-0:4.16.4-202407191908.p0.g057a9af.assembly.4.16.4.el9.noarch
microshift-release-info-0:4.16.5-202407250951.p0.g0afcb57.assembly.4.16.5.el9.noarch
microshift-release-info-0:4.16.6-202408010822.p0.gc4ded66.assembly.4.16.6.el9.noarch
microshift-release-info-0:4.16.7-202408081107.p0.g0597bb8.assembly.4.16.7.el9.noarch
microshift-release-info-0:4.16.8-202408150851.p0.gc8a3bb1.assembly.4.16.8.el9.noarch
microshift-release-info-0:4.16.9-202408220842.p0.gefa92a2.assembly.4.16.9.el9.noarch
    Copy to Clipboard Toggle word wrap

  2. 运行以下命令下载您想要的 RPM 软件包： 

    $ sudo dnf download microshift-release-info-<release_version>
    1
    Copy to Clipboard Toggle word wrap
    1
    将 < release_version > 替换为您要部署的发行版本的数字值，使用整个版本号，如 4.16.0。

    输出示例

    microshift-release-info-4.16.0.-202311101230.p0.g7dc6a00.assembly.4.16.0.el9.noarch.rpm
    1
    Copy to Clipboard Toggle word wrap

    1
    您的输出应包含日期和时间 ID。

  3. 运行以下命令解包 RPM 软件包而不安装它： 

    $ rpm2cpio <microshift_release_info> | cpio -idmv
    1
    Copy to Clipboard Toggle word wrap
    1
    将 <microshift_release_info > 替换为上一步中的 RPM 软件包的名称。例如，microshift-release-info-4.16.10-202408291007.p0.g6e4ee4d.assembly.4.16.10.el9.noarch.rpm。

    输出示例

    ./usr/share/microshift
./usr/share/microshift/blueprint
./usr/share/microshift/blueprint/blueprint-aarch64.toml
./usr/share/microshift/blueprint/blueprint-x86_64.toml
./usr/share/microshift/release
./usr/share/microshift/release/release-aarch64.json
./usr/share/microshift/release/release-x86_64.json
    Copy to Clipboard Toggle word wrap

  4. 运行以下命令列出内容： 

    $ cat ./usr/share/microshift/release/release-x86_64.json
    Copy to Clipboard Toggle word wrap

    输出示例

    {
  "release": {
    "base": "4.16.10"
  },
  "images": {
    "cli": "....
# ...
    Copy to Clipboard Toggle word wrap

法律通告
复制链接

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

© 2025 Red Hat