documentation.suse.com / SUSE Edge 文档 / Day 2 操作 / Edge 3.3 迁移

34 Edge 3.3 迁移

本章介绍如何将管理群集和下游群集从 Edge 3.2 迁移到 Edge 3.3.0

重要
重要

始终从 Edge 3.2最新 z-stream 版本执行群集迁移。

始终迁移到 Edge 3.3.0 版本。对于迁移后的后续升级,请参见管理群集(第 35 章 “管理群集)和下游群集(第 36 章 “下游群集)章节。

34.1 管理群集

本节将介绍以下主题:

第 34.1.1 节 “先决条件” - 开始迁移前需要完成的先决步骤。

第 34.1.2 节 “升级控制器” - 如何使用第 23 章 “升级控制器执行管理群集迁移。

第 34.1.3 节 “Fleet” - 如何使用第 8 章 “Fleet执行管理群集迁移。

34.1.1 先决条件

34.1.1.1 升级裸机操作器 CRD

注意
注意

仅适用于需要进行 第 10 章 “Metal3 chart 升级的群集。

Metal3 Helm chart 利用 Helm 的 CRD 目录来包含裸机操作器 (BMO) CRD。

然而,这种方法存在一定的局限性,特别是无法使用 Helm 升级此目录中的 CRD。有关详细信息,请参见 Helm 文档

因此,在将 Metal3 升级到与 Edge 3.3.0 兼容的版本之前,用户必须手动升级底层的 BMO CRD。

在安装了 Helmkubectl 已配置为指向管理群集的计算机上:

  1. 手动应用 BMO CRD:

    helm show crds oci://registry.suse.com/edge/charts/metal3 --version 303.0.7+up0.11.5 | kubectl apply -f -

34.1.2 升级控制器

重要
重要

升级控制器目前仅支持非隔离管理群集的 Edge 版本迁移。

本节将介绍以下主题:

第 34.1.2.1 节 “先决条件” - 针对升级控制器的先决条件。

第 34.1.2.2 节 “迁移步骤” - 使用升级控制器管理群集迁移到新 Edge 版本的步骤。

34.1.2.1 先决条件

34.1.2.1.1 Edge 3.3 升级控制器

使用升级控制器之前,必须先确保其运行的版本能够迁移到目标 Edge 版本。

操作步骤如下:

  1. 如果您已在之前的 Edge 版本中部署了升级控制器,请升级其 chart:

    helm upgrade upgrade-controller -n upgrade-controller-system oci://registry.suse.com/edge/charts/upgrade-controller --version 303.0.1+up0.1.1
  2. 如果您尚部署升级控制器,请按照第 23.3 节 “安装升级控制器”中所述操作。

34.1.2.2 迁移步骤

使用升级控制器执行管理群集迁移本质上与执行升级类似。

唯一的区别是,UpgradePlan 必须指定 3.3.0 版本:

apiVersion: lifecycle.suse.com/v1alpha1
kind: UpgradePlan
metadata:
  name: upgrade-plan-mgmt
  # Change to the namespace of your Upgrade Controller
  namespace: CHANGE_ME
spec:
  releaseVersion: 3.3.0

有关如何使用上述 UpgradePlan 进行迁移的信息,请参见升级控制器升级过程(第 35.1 节 “升级控制器”)。

34.1.3 Fleet

注意
注意

只要有可能,便使用第 34.1.2 节 “升级控制器”进行迁移。

仅在升级控制器未涵盖的使用场景下,才需参考本节内容。

使用 Fleet 执行管理群集迁移本质上与执行升级类似。

主要区别在于:

  1. 必须使用 release-3.3.0 版本 suse-edge/fleet-examples 储存库中的 Fleet。

  2. 安排升级的 chart 必须升级到与 Edge 3.3.0 版本兼容的版本。有关 Edge 3.3.0 组件的列表,请参见第 52.4 节 “版本 3.3.0”

重要
重要

为确保 Edge 3.3.0 迁移成功,用户必须遵守上述要点。

鉴于上述要点,用户可参考管理群集 Fleet(第 35.2 节 “Fleet”)文档,获取执行迁移需要完成的步骤的全面指南。

34.2 下游群集

第 34.2.1 节 “Fleet” - 如何使用第 8 章 “Fleet执行下游群集迁移。

34.2.1 Fleet

使用 Fleet 执行下游群集迁移本质上与执行升级类似。

主要区别在于:

  1. 必须使用 release-3.3.0 版本 suse-edge/fleet-examples 储存库中的 Fleet。

  2. 安排升级的 chart 必须升级到与 Edge 3.3.0 版本兼容的版本。有关 Edge 3.3.0 组件的列表,请参见第 52.4 节 “版本 3.3.0”

重要
重要

为确保 Edge 3.3.0 迁移成功,用户必须遵守上述要点。

鉴于上述要点,用户可参考下游群集 Fleet(第 36.1 节 “Fleet”)文档,获取执行迁移需要完成的步骤的全面指南。

Documentation survey