33 Edge 3.2のマイグレーション #

このセクションでは、管理クラスタとダウンストリームクラスタをEdge 3.1からEdge 3.2.0に移行する方法について説明します。

重要

クラスタマイグレーションは常に、Edge 3.1の 最新のZストリームリリースから実行してください。

常に、Edge 3.2.0リリースに移行してください。マイグレーション後のアップグレードについては、管理クラスタ(第34章「管理クラスタ」)およびダウンストリームクラスタ(第35章「ダウンストリームクラスタ」)のセクションを参照してください。

33.1 管理クラスタ #

このセクションでは、次のトピックについて説明します。

33.1.1項「前提条件」 - マイグレーションを開始する前に完了する必要がある前提条件の手順。

33.1.2項「Upgrade Controller」 - 管理クラスタのマイグレーションを第23章「Upgrade Controller」を使用して実行する方法。

33.1.3項「Fleet」 - 管理クラスタのマイグレーションを第8章「Fleet」を使用して実行する方法。

33.1.1 前提条件 #

33.1.1.1 Bare Metal Operator CRDのアップグレード #

注記

第10章「Metal³」チャートのアップグレードが必要なクラスタにのみ適用されます。

Metal³ Helmチャートには、Bare Metal Operator (BMO) CRDが含まれており、これはHelmのCRDディレクトリを活用することで提供されています。

ただし、このアプローチには特定の制限があり、特にHelmを使用してこのディレクトリ内のCRDをアップグレードできません。詳細については、Helmのドキュメントを参照してください。

そのため、Metal³をEdge 3.2.0互換のバージョンにアップグレードする前に、ユーザは基盤となるBMO CRDを手動でアップグレードする必要があります。

Helmがインストールされ、kubectlが管理 クラスタを指すように設定されているマシンで、次の手順を実行します。

BMO CRDを手動で適用します。

helm show crds oci://registry.suse.com/edge/3.2/metal3-chart --version 302.0.0+up0.9.0 | kubectl apply -f -

33.1.2 Upgrade Controller #

重要

Upgrade Controllerは現在、非エアギャップ管理クラスタに対してのみEdgeリリースのマイグレーションをサポートしています。

次のトピックは、このセクションの一部として説明します。

33.1.2.1項「前提条件」 - Upgrade Controllerに固有の前提条件。

33.1.2.2項「マイグレーション手順」 - Upgrade Controllerを使用して、管理クラスタを新しいEdgeバージョンに移行するための手順。

33.1.2.1 前提条件 #

33.1.2.1.1 Edge 3.2 Upgrade Controller #

Upgrade Controllerを使用する前に、まず目的のEdgeリリースに移行できるバージョンが実行されていることを確認する必要があります。

このためには:

以前のEdgeリリースからUpgrade Controllerがすでにデプロイされている場合は、そのチャートをアップグレードします。
```
helm upgrade upgrade-controller -n upgrade-controller-system oci://registry.suse.com/edge/3.2/upgrade-controller-chart --version 302.0.0+up0.1.1
```
Upgrade Controllerがデプロイされていない場合は、23.3項「Upgrade Controllerのインストール」に従います。

33.1.2.2 マイグレーション手順 #

Upgrade Controllerを使用した管理クラスタのマイグレーションの実行は、アップグレードの実行と基本的に類似しています。

唯一の違いは、UpgradePlanが3.2.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.2.0

上記のUpgradePlanを使用してマイグレーションを実行する方法については、Upgrade Controllerのアップグレードプロセス(34.1項「Upgrade Controller」)を参照してください。

33.1.3 Fleet #

注記

可能な限り、マイグレーションには33.1.2項「Upgrade Controller」を使用してください。

Upgrade Controllerでカバーされていないユースケースの場合にのみ、このセクションを参照してください。

Fleetを使用した管理クラスタのマイグレーションの実行は、基本的にアップグレードの実行と類似しています。

主な違いは次のとおりです。

フリートはsuse-edge/fleet-examplesリポジトリのrelease-3.2.0リリースから使用される必要があります。
アップグレードがスケジュールされているチャートは、Edge 3.2.0リリースと互換性のあるバージョンにアップグレードする 必要があります。Edge 3.2.0コンポーネントのリストについては、 51.4項「リリース3.0.2」を参照してください。

重要

Edge 3.2.0へのマイグレーションを成功させるには、ユーザが上記の点に従うことが重要です。

上記の点を踏まえて、ユーザはマイグレーションの実行に必要な手順に関する包括的なガイドとして、管理 クラスタFleet (34.2項「Fleet」)のドキュメントを参照することができます。

33.2 ダウンストリームクラスタ #

33.2.1項「Fleet」 - 第8章「Fleet」を使用してダウンストリームクラスタのマイグレーションを実行する方法。

33.2.1 Fleet #

Fleetを使用したダウンストリームクラスタのマイグレーションの実行は、アップグレードの実行と基本的に類似しています。

主な違いは次のとおりです。

フリートはsuse-edge/fleet-examplesリポジトリのrelease-3.2.0リリースから使用される必要があります。
アップグレードがスケジュールされているチャートは、Edge 3.2.0リリースと互換性のあるバージョンにアップグレードする 必要があります。Edge 3.2.0コンポーネントのリストについては、 51.4項「リリース3.0.2」を参照してください。

重要

Edge 3.2.0へのマイグレーションを成功させるには、ユーザが上記の点に従うことが重要です。

上記の点を踏まえて、ユーザはマイグレーションの実行に必要な手順に関する包括的なガイドとして、 ダウンストリームクラスタFleet (35.1項「Fleet」)のドキュメントに従うことができます。