4 リリース1.8へのアップグレード
この項では、リリース1.7からリリース1.8にOracle Cloud Native Environmentをアップグレードする方法について説明します。
Oracle Cloud Native EnvironmentパッケージおよびKubernetesクラスタをリリース1.8にアップグレードすると、このリリースの新機能を使用できます。
この章の各ステップを実行して、環境をリリース1.7からリリース1.8にアップグレードします。
重要:
リリース1.8にアップグレードする前に、Oracle Cloud Native Environmentリリース1.7の最新のエラータ・リリースに更新します。 環境の更新の詳細は、「リリース1.7の更新およびアップグレード」を参照してください。ソフトウェア・パッケージのソースの変更
この項では、Oracle Cloud Native EnvironmentソフトウェアをアップグレードするOSのソフトウェア・パッケージのロケーションの設定について説明します。
Oracle Linux 9
ノード上のOSがOracle Linux 9の場合は、この項の情報を使用してパッケージ・ソースを更新します。
システム更新にOracle Linux yumサーバーを使用している場合は、各ノードでoracle-olcne-release-el9
リリース・パッケージを更新します。 ol9_olcne18
リポジトリを有効にし、以前のリリースのol9_olcne17
リポジトリを無効にします。
各ノードで次を実行します。
sudo dnf update oracle-olcne-release-el9
sudo dnf config-manager --enable ol9_olcne18
sudo dnf config-manager --disable ol9_olcne17
システムがULNを使用するように登録されている場合は、ULN webインタフェースを使用して各システムをol9_x86_64_olcne18
チャネルにサブスクライブします。 各システムを、以前のリリース用のol9_x86_64_olcne17
チャネルからサブスクライブ解除してください。
Oracle Linux 8
ノード上のOSがOracle Linux 8の場合は、この項の情報を使用してパッケージ・ソースを更新します。
システム更新にOracle Linux yumサーバーを使用している場合は、各ノードでoracle-olcne-release-el8
リリース・パッケージを更新します。 ol8_olcne18
リポジトリを有効にし、以前のリリースのリポジトリを無効にします。 次のリポジトリを無効にします:
-
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_olcne18
sudo dnf config-manager --disable ol8_olcne17 ol8_olcne16 ol8_olcne15 ol8_olcne14 ol8_olcne13 ol8_olcne12
システムがULNを使用するように登録されている場合は、ULN webインタフェースを使用して各システムをol8_x86_64_olcne18
チャネルにサブスクライブします。 必ず、次のチャネルから各システムを登録解除してください:
-
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.28.8にアップグレードします。
オペレータ・ノードで、olcnectl module update
コマンドを使用して、Oracle Cloud Native Environmentリリース1.8で使用可能な最新のKubernetesリリースにアップグレードします。 この例では、myenvironment
環境のmycluster
という名前のKubernetesモジュールをKubernetesリリース1.28.8にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name mycluster \
--kube-version 1.28.8
--kube-version
オプションでは、アップグレード先のリリースを指定します。 この例では、リリース番号1.28.8を使用します。
重要:
必ず最新のKubernetesリリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新のKubernetesリリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
オプションで、--log-level
オプションを使用して、コマンド出力に表示されるロギングのレベルを設定できます。 デフォルトでは、エラー・メッセージが表示されます。 たとえば、次を含めると、すべてのメッセージが表示されるようにロギング・レベルを設定できます:
--log-level debug
ログ・メッセージは、操作ログとしても保存されます。 操作ログは、コマンドの実行中または完了時に表示できます。 操作ログの使用方法の詳細は、「Platform Command-Line Interface」を参照してください。
クラスタ内の各ノードが最新のKubernetesリリースにアップグレードされるときに、クラスタの状態が検証され、アップグレードが完了します。
Multusモジュールのアップグレード
Multusモジュールがインストールされている場合は、Multusモジュールをアップグレードする必要があります。
重要:
この項の各コンポーネントの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
Multusをアップグレードするには、オペレータ・ノードで、olcnectl module update
コマンドを使用して、Oracle Cloud Native Environmentリリース1.8で使用可能な最新のMultusリリースにアップグレードします。 この例では、myenvironment
環境のmymultus
という名前のMultusモジュールをMultusリリース4.0.2にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name mymultus \
--multus-version 4.0.2
--multus-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号4.0.2を使用します。
重要:
最新のMultusリリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新のMultusリリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
オプションで、--log-level
オプションを使用して、コマンド出力に表示されるロギングのレベルを設定できます。 デフォルトでは、エラー・メッセージが表示されます。 たとえば、次を含めると、すべてのメッセージが表示されるようにロギング・レベルを設定できます:
--log-level debug
ログ・メッセージは、操作ログとしても保存されます。 操作ログは、コマンドの実行中または完了時に表示できます。 操作ログの使用方法の詳細は、「Platform Command-Line Interface」を参照してください。
Oracle Cloud Infrastructure Cloud Controller Managerモジュールのアップグレード
Oracle Cloud Infrastructure Cloud Controller Managerモジュールがインストールされている場合は、アップグレードも必要です。
Oracle Cloud Infrastructure Cloud Controller Managerモジュールをアップグレードするには、オペレータ・ノードでolcnectl module update
コマンドを使用します。 この例では、myenvironment
環境のmyoci
という名前のモジュールをOracle Cloud Infrastructure Cloud Controller Managerモジュール・リリース1.27.0にアップグレード
olcnectl module update \
--environment-name myenvironment \
--name myoci \
--oci-ccm-version 1.27.0 \
--oci-container-registry "" \
--ccm-container-registry ""
--oci-ccm-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号1.27.0を使用します。
重要:
必ず、Oracle Cloud Infrastructure Cloud Controller Managerモジュールの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
レジストリ・オプション--oci-container-registry
および--ccm-container-registry
の場合、この例では、パブリック・レジストリが使用されていることを前提としており、両方のオプションが空の文字列(""
)に設定されているため、Platform API Serverでは、Oracle Cloud Infrastructure Cloud Controller Managerコンテナ・イメージをプルする正しいパブリック・コンテナ・レジストリが自動的に構成されます。 ただし、プライベート・レジストリを使用しており、インストール・プロセス中に--oci-container-registry
および--ccm-container-registry
の値をすでに設定している場合は、これらのオプションを指定する必要はありません。
オプションで、--log-level
オプションを使用して、コマンド出力に表示されるロギングのレベルを設定できます。 デフォルトでは、エラー・メッセージが表示されます。 たとえば、次を含めると、すべてのメッセージが表示されるようにロギング・レベルを設定できます:
--log-level debug
ログ・メッセージは、操作ログとしても保存されます。 操作ログは、コマンドの実行中または完了時に表示できます。 操作ログの使用方法の詳細は、「Platform Command-Line Interface」を参照してください。
MetalLBモジュールのアップグレード
MetalLBモジュールがインストールされている場合は、それもアップグレードする必要があります。
MetalLBモジュールをアップグレードするには、オペレータ・ノードでolcnectl module update
コマンドを使用します。 この例では、myenvironment
環境のmymetallb
という名前のモジュールをMetalLBモジュール・リリース0.13.10にアップグレード
olcnectl module update \
--environment-name myenvironment \
--name mymetallb \
--metallb-version 0.13.10
--metallb-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号0.13.10を使用します。
重要:
必ず、MetalLBモジュールの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
オプションで、--log-level
オプションを使用して、コマンド出力に表示されるロギングのレベルを設定できます。 デフォルトでは、エラー・メッセージが表示されます。 たとえば、次を含めると、すべてのメッセージが表示されるようにロギング・レベルを設定できます:
--log-level debug
ログ・メッセージは、操作ログとしても保存されます。 操作ログは、コマンドの実行中または完了時に表示できます。 操作ログの使用方法の詳細は、「Platform Command-Line Interface」を参照してください。
Istioモジュールのアップグレード
Istioモジュールがインストールされている場合は、それもアップグレードする必要があります。
重要:
この項の各コンポーネントの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
オペレータ・ノードでIstioをアップグレードするには、olcnectl module update
コマンドを使用して、Oracle Cloud Native Environmentリリース1.8で使用可能な最新のIstioリリースにアップグレードします。 この例では、myenvironment
環境のmyistio
という名前のIstioモジュールをIstioリリース1.19.9にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name myistio \
--istio-version 1.19.9
--istio-version
オプションでは、アップグレード先のリリースを指定します。 この例では、リリース番号1.19.9を使用します。
Istioリリース1.19.9にアップグレードすると、各Istioリリースをリリース1.19.9まで繰り返し処理します。 クラスタ内の各ノードが次のIstioリリースにアップグレードされるときに、クラスタの状態が検証されます。 クラスタが正常の場合、すべてのノードが最新のIstioリリースにアップグレードされるまで、バックアップのサイクル、次のリリースへのアップグレード、クラスタ検証が再度開始されます。
オプションで、--log-level
オプションを使用して、コマンド出力に表示されるロギングのレベルを設定できます。 デフォルトでは、エラー・メッセージが表示されます。 たとえば、次を含めると、すべてのメッセージが表示されるようにロギング・レベルを設定できます:
--log-level debug
ログ・メッセージは、操作ログとしても保存されます。 操作ログは、コマンドの実行中または完了時に表示できます。 操作ログの使用方法の詳細は、「Platform Command-Line Interface」を参照してください。
Rookモジュールのアップグレード
Rookモジュールがインストールされている場合は、それをアップグレードする必要もあります。
Rookモジュールをアップグレードするには、オペレータ・ノードでolcnectl module update
コマンドを使用します。 この例では、myenvironment
環境のmyrook
という名前のモジュールをRookモジュール・リリース1.12.3にアップグレード
olcnectl module update \
--environment-name myenvironment \
--name myrook \
--rook-version 1.12.3
--rook-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号1.12.3を使用します。
重要:
Rookモジュールの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
オプションで、--log-level
オプションを使用して、コマンド出力に表示されるロギングのレベルを設定できます。 デフォルトでは、エラー・メッセージが表示されます。 たとえば、次を含めると、すべてのメッセージが表示されるようにロギング・レベルを設定できます:
--log-level debug
ログ・メッセージは、操作ログとしても保存されます。 操作ログは、コマンドの実行中または完了時に表示できます。 操作ログの使用方法の詳細は、「Platform Command-Line Interface」を参照してください。
KubeVirtモジュールのアップグレード
KubeVirtモジュールがインストールされている場合は、それもアップグレードする必要があります。
KubeVirtモジュールをアップグレードするには、オペレータ・ノードでolcnectl module update
コマンドを使用します。 この例では、myenvironment
環境のmykubevirt
という名前のモジュールをKubeVirtモジュール・リリース0.59.0にアップグレード
olcnectl module update \
--environment-name myenvironment \
--name mykubevirt \
--kubevirt-version 0.59.0
--kubevirt-version
オプションは、アップグレードするリリースを指定します。 この例では、リリース番号0.59.0を使用します。
重要:
KubeVirtモジュールの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.8の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
オプションで、--log-level
オプションを使用して、コマンド出力に表示されるロギングのレベルを設定できます。 デフォルトでは、エラー・メッセージが表示されます。 たとえば、次を含めると、すべてのメッセージが表示されるようにロギング・レベルを設定できます:
--log-level debug
ログ・メッセージは、操作ログとしても保存されます。 操作ログは、コマンドの実行中または完了時に表示できます。 操作ログの使用方法の詳細は、「Platform Command-Line Interface」を参照してください。