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

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

34.1.1 前提条件

 

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

 
注記
注記

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

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

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

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

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

  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 Upgrade Controller

 
重要
重要

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

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

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

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

34.1.2.1 前提条件

 
34.1.2.1.1 Edge 3.3 Upgrade Controller
 

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

このためには:

  1. 以前のEdgeリリースからUpgrade Controllerがすでにデプロイされている場合は、そのチャートをアップグレードします。

    helm upgrade upgrade-controller -n upgrade-controller-system oci://registry.suse.com/edge/charts/upgrade-controller --version 303.0.1+up0.1.1

  2. Upgrade Controllerがデプロイされていない場合は、23.3項 「Upgrade Controllerのインストール」に従います。

34.1.2.2 マイグレーション手順

 

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

唯一の違いは、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を使用してマイグレーションを実行する方法については、Upgrade Controllerのアップグレードプロセス(35.1項 「Upgrade Controller」)を参照してください。

34.1.3 Fleet

 
注記
注記

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

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

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

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

  1. フリートはsuse-edge/fleet-examplesリポジトリのrelease-3.3.0リリースから使用される必要があります。

  2. アップグレードがスケジュールされているチャートは、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. フリートはsuse-edge/fleet-examplesリポジトリのrelease-3.3.0リリースから使用される必要があります。

  2. アップグレードがスケジュールされているチャートは、Edge 3.3.0リリースと互換性のあるバージョンにアップグレードする 必要があります。Edge 3.3.0コンポーネントのリストについては、 52.4項 「リリース3.3.0」を参照してください。

重要
重要

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

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

Documentation survey