適用項目 SUSE Telco Cloud 3.7

58 エッジ 3.7 移行 #

このセクションでは、management および downstream クラスタを SUSE Telco Cloud 3.6 から SUSE Telco Cloud 3.7.0 へマイグレーションする方法を説明します。

重要

クラスタのマイグレーションは、必ず latest Z-stream の SUSE Telco Cloud 3.6 リリースから実行してください。

必ず SUSE Telco Cloud 3.7.0 リリースへマイグレーションしてください。マイグレーション後のアップグレードについては、管理 (第59章「管理クラスタ」) を参照してください。セクション。

次の表に、さまざまな種類のクラスタとクラスタをアップグレードする方法を示します。

表 58.1: ダウンストリームクラスタの種類とアップグレード方法 #

クラスタのタイプ	メソッド
EIBでプロビジョニングされたクラスタ	詳細については58.1.3項「Fleet」を参照してください。
Metal³でプロビジョニングされたクラスタ	詳細はダウンストリームクラスタのアップグレード (60.3項「ダウンストリームクラスターのアップグレード」) を参照してください。

58.1 管理クラスタ #

この章の構成は次のとおりです。

58.1.1項「前提条件」 - マイグレーション開始前に完了すべき前提条件の手順。

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

58.1.3項「Fleet」 - management を使用して第9章「Fleet」クラスタマイグレーションを実行する方法。

58.1.1 前提条件 #

58.1.1.1 ベアメタル Operator CRDのアップグレード #

注記

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

Metal³ Helmチャートには、HelmのCRDディレクトリを活用することで、ベアメタル Operator (BMO) CRDが含まれています。

ただし、このアプローチには特定の制限があり、特にこのディレクトリ内のCRDをHelmを使用してアップグレードできないという点があります。詳細については、Helmマニュアルを参照してください。

その結果、Metal³を`SUSE Telco Cloud 3.7.0`互換バージョンにアップグレードする前に、ユーザーは基盤となるBMO CRDを手動でアップグレードする必要があります。

Helm`がインストールされ、`kubectl`がmanagement`クラスタを指すように設定されているマシンで、以下を実行します。

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

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

58.1.2 Upgrade Controller #

重要

Upgrade Controller`は現在、*非エアギャップ(された)管理*クラスターに対するSUSE Telco Cloud`リリース移行のみをサポートしています。

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

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

58.1.2.2項「移行手順」 - Upgrade Controller`を使用してmanagement`クラスターを新しい`SUSE Telco Cloud`バージョンに移行する手順。

58.1.2.1 前提条件 #

58.1.2.1.1 SUSE Telco Cloud 3.7 Upgrade Controller #

Upgrade Controller`を使用する前に、目的のSUSE Telco Cloud`リリースへの移行が可能なバージョンで実行されていることを確認する必要があります。

これには次の操作を行います。

以前の`Upgrade Controller`リリースから`SUSE Telco Cloud`が既にデプロイされている場合は、そのチャートをアップグレードしてください。
```
helm upgrade upgrade-controller -n upgrade-controller-system oci://registry.suse.com/edge/charts/upgrade-controller --version 307.0.4+up0.1.3
```
`Upgrade Controller`がデプロイされて*いない*場合は、21.3項「Upgrade Controllerのインストール」に従ってください。

58.1.2.2 移行手順 #

Upgrade Controller`を使用したmanagement`クラスターの移行は、基本的にアップグレードの実行と似ています。

唯一の違いは、UpgradePlan`で3.7.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.7.0

上記の`UpgradePlan`を使用して移行を行う方法については、Upgrade Controller アップグレード処理 (59.1項「Upgrade Controller」)を参照してください。

58.1.3 Fleet #

注記

可能な限り、移行には58.1.2項「Upgrade Controller」を使用してください。

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

Fleet`を使用したmanagement`クラスターの移行は、基本的にアップグレードの実行と似ています。

*主な*違いは以下の通りです。

Fleetは、`suse-edge/fleet-examples`リポジトリのrelease-3.7.0リリースから*使用する必要があります*。
アップグレードが予定されているチャートは、SUSE Telco Cloud 3.7.0`リリースと互換性のあるバージョンに*アップグレードする必要があります*。SUSE Telco Cloud 3.7.0`コンポーネントのリストについては、78.3項「リリース 3.7.0。」を参照してください。

重要

`SUSE Telco Cloud 3.7.0`移行を確実に成功させるため、ユーザーは上記で概説した点に従うことが重要です。

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

58.2.1項「Fleet」 - downstream を使用して第9章「Fleet」クラスタマイグレーションを実行する方法。

58.2.1 Fleet #

`downstream`を使用した`Fleet`クラスタの移行は、基本的にアップグレードの実行と似ています。

*主な*違いは以下の通りです。

Fleetは、`suse-edge/fleet-examples`リポジトリのrelease-3.7.0リリースから*使用する必要があります*。
アップグレードが予定されているチャートは、SUSE Telco Cloud 3.7.0`リリースと互換性のあるバージョンに*アップグレードする必要があります*。SUSE Telco Cloud 3.7.0`コンポーネントのリストについては、78.3項「リリース 3.7.0。」を参照してください。

重要

`SUSE Telco Cloud 3.7.0`移行を確実に成功させるため、ユーザーは上記で概説した点に従うことが重要です。