4 リリース1.7へのアップグレード
重要:
このドキュメントで説明されているソフトウェアは、Extended SupportまたはSustaining Supportにあります。 詳細は、「Oracleオープン・ソース・サポート・ポリシー」を参照してください。
このドキュメントに記載されているソフトウェアをできるだけ早くアップグレードすることをお勧めします。
この項では、リリース1.6からリリース1.7にOracle Cloud Native Environmentをアップグレードする方法について説明します。
Oracle Cloud Native EnvironmentパッケージおよびKubernetesクラスタをリリース1.7にアップグレードすると、このリリースの新機能を使用できます。
この章の各ステップを実行して、環境をリリース1.6からリリース1.7にアップグレードします。
重要:
リリース1.7にアップグレードする前に、Oracle Cloud Native Environmentリリース1.6の最新のエラータ・リリースに更新します。 環境の更新の詳細は、「リリース1.6の更新およびアップグレード」を参照してください。重要:
Glusterモジュールがインストールされている場合は、「インストールされたGlusterモジュールでのアップグレード」に示すステップを使用してアップグレードします。ソフトウェア・パッケージのソースの変更
この項では、Oracle Cloud Native EnvironmentソフトウェアをアップグレードするOSのソフトウェア・パッケージのロケーションの設定について説明します。
Oracle Linux 8
ノード上のOSがOracle Linux 8の場合は、この項の情報を使用してパッケージ・ソースを更新します。
システム更新にOracle Linux yumサーバーを使用している場合は、各ノードでoracle-olcne-release-el8
リリース・パッケージを更新します。 ol8_olcne17
リポジトリを有効にし、以前のリリースのリポジトリを無効にします。 次のリポジトリを無効にします:
-
ol8_olcne16
-
ol8_olcne15
-
ol8_olcne14
-
ol8_olcne13
-
ol8_olcne12
各ノードで次を実行します。
sudo dnf update oracle-olcne-release-el8
sudo dnf config-manager --enable ol8_olcne17
sudo dnf config-manager --disable ol8_olcne16 ol8_olcne15 ol8_olcne14 ol8_olcne13 ol8_olcne12
システムがULNを使用するように登録されている場合は、ULN webインタフェースを使用して各システムをol8_x86_64_olcne17
チャネルにサブスクライブします。 必ず、次のチャネルから各システムを登録解除してください:
-
ol8_x86_64_olcne16
-
ol8_x86_64_olcne15
-
ol8_x86_64_olcne14
-
ol8_x86_64_olcne13
-
ol8_x86_64_olcne12
オペレータ・ノードのアップグレード
新しいOracle Cloud Native Environmentソフトウェア・パッケージでオペレータ・ノードをアップグレードします。
Oracle Linuxのオペレータ・ノードをアップグレードするには:
-
オペレータ・ノードで、
olcne-api-server
サービスを停止します。sudo systemctl stop olcne-api-server.service
-
Platform CLI、Platform API Server、ユーティリティ・パッケージを更新します:
sudo dnf update olcnectl olcne-api-server olcne-utils
-
olcne-api-server
サービスを開始します。sudo systemctl start olcne-api-server.service
Kubernetesノードのアップグレード
新しいOracle Cloud Native Environmentソフトウェア・パッケージでKubernetesノードをアップグレードします。
オペレータ・ノードで、olcnectl environment update
コマンドを使用して、環境内の各ノードでPlatform Agentをアップグレードします。 この例では、myenvironment
環境のすべてのノードでPlatform Agentをアップグレードします。
olcnectl environment update olcne \
--environment-name myenvironment
Platform Agentがアップグレードされ、各ノードでサービスが再起動されます。
Kubernetesクラスタのアップグレード
クラスタをKubernetesリリース1.26.15にアップグレードします。
オペレータ・ノードで、olcnectl module update
コマンドを使用して、Oracle Cloud Native Environmentリリース1.7で使用可能な最新のKubernetesリリースにアップグレードします。 この例では、myenvironment
環境のmycluster
という名前のKubernetesモジュールをKubernetesリリース1.26.15にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name mycluster \
--kube-version 1.26.15
--kube-version
オプションでは、アップグレード先のリリースを指定します。 この例では、リリース番号1.26.15を使用します。
重要:
必ず最新のKubernetesリリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.7の最新のKubernetesリリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
クラスタ内の各ノードが最新のKubernetesリリースにアップグレードされるときに、クラスタの状態が検証され、アップグレードが完了します。
Calicoモジュールのアップグレード
Calicoモジュールがインストールされている場合は、アップグレードする必要があります。
重要:
この項の各コンポーネントの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.7の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
Calicoをアップグレードするには、オペレータ・ノードで、olcnectl module update
コマンドを使用して、Oracle Cloud Native Environmentリリース1.7で使用可能な最新のCalicoリリースにアップグレードします。 この例では、myenvironment
環境のmycalico
という名前のCalicoモジュールをCalicoリリース3.25.1にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name mycalico \
--calico-version 3.25.1
--calico-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号3.25.1を使用します。
Multusモジュールのアップグレード
Multusモジュールがインストールされている場合は、Multusモジュールをアップグレードする必要があります。
重要:
この項の各コンポーネントの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.7の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
Multusをアップグレードするには、オペレータ・ノードで、olcnectl module update
コマンドを使用して、Oracle Cloud Native Environmentリリース1.7で使用可能な最新のMultusリリースにアップグレードします。 この例では、myenvironment
環境のmymultus
という名前のMultusモジュールをMultusリリース4.0.1にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name mymultus \
--multus-version 4.0.1
--multus-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号4.0.1を使用します。
MetalLBモジュールのアップグレード
MetalLBモジュールがインストールされている場合は、それもアップグレードする必要があります。
MetalLBモジュールをアップグレードするには、オペレータ・ノードでolcnectl module update
コマンドを使用します。 この例では、myenvironment
環境のmymetallb
という名前のモジュールをMetalLBモジュール・リリース0.13.9にアップグレード
olcnectl module update \
--environment-name myenvironment \
--name mymetallb \
--metallb-version 0.13.9
--metallb-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号0.13.9を使用します。
重要:
必ず、MetalLBモジュールの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.7の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
Istioモジュールのアップグレード
Istioモジュールがインストールされている場合は、それもアップグレードする必要があります。
重要:
この項の各コンポーネントの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.7の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
オペレータ・ノードでIstioをアップグレードするには、olcnectl module update
コマンドを使用して、Oracle Cloud Native Environmentリリース1.7で使用可能な最新のIstioリリースにアップグレードします。 この例では、myenvironment
環境のmyistio
という名前のIstioモジュールをIstioリリース1.17.8にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name myistio \
--istio-version 1.17.8
--istio-version
オプションでは、アップグレード先のリリースを指定します。 この例では、リリース番号1.17.8を使用します。
Istioリリース1.17.8にアップグレードすると、各Istioリリースをリリース1.17.8まで繰り返し処理します。 クラスタ内の各ノードが次のIstioリリースにアップグレードされるときに、クラスタの状態が検証されます。 クラスタが正常の場合、すべてのノードが最新のIstioリリースにアップグレードされるまで、バックアップのサイクル、次のリリースへのアップグレード、クラスタ検証が再度開始されます。
インストールされたGlusterモジュールでのアップグレード
Glusterモジュールがインストールされている場合は、別のメソッドを使用してOracle Cloud Native Environmentリリース1.7へのアップグレードを実行する必要があります。 これは、Glusterモジュールがリリース1.7に含まれていないため、アップグレードできません。 この項では、Glusterモジュールのインストール時に環境をアップグレードする方法を示します。
アップグレード中に、Rookモジュールをインストールし、Cephクラスタとストレージを設定してGlusterストレージを置き換える必要があります。 Cephストレージが設定されている場合、Kubernetesアプリケーションを移行して、GlusterのかわりにCephを使用できます。 アプリケーションの移行後、Kubernetesモジュールおよびその他のモジュールをアップグレードします。
Glusterモジュールがインストールされているときにリリース1.7にアップグレードするには:
- 「ソフトウェア・パッケージ・ソースの変更」のステップを使用して、ソフトウェア・パッケージ・ソースを変更します。
- 「オペレータ・ノードのアップグレード」のステップを使用して、オペレータ・ノードをアップグレードします。
- 「Kubernetesノードの更新」のステップを使用して、KubernetesノードでOracle Cloud Native Environmentソフトウェアをアップグレードします。
- Rookモジュールをインストールし、「Rookモジュール」の情報を使用してCephストレージを設定します。
- Cephストレージを使用するようにKubernetesアプリケーションを移行します。 GlusterからCephへの移行を実行するメソッドは、このドキュメントの範囲外です。 この移行を実行するための単一のメソッドはありません。 少なくとも、PersistentVolumeClaimsを変更して、Cephの設定時に作成した新しいCeph StorageClassesを使用する必要があります。
- オペレータ・ノードで、
olcnectl module uninstall
コマンドを使用してGlusterモジュールを削除します:olcnectl module uninstall \ --environment-name environment_name \ --name module_name
- 「Kubernetesクラスタのアップグレード」のステップを使用して、Kubernetesモジュールをアップグレードします。
- このガイドで説明するように、インストールしたその他のモジュールをアップグレードします。