機械翻訳について

4 リリース1.8へのアップグレード

この項では、リリース1.7からリリース1.8Oracle 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のオペレータ・ノードをアップグレードするには:

  1. オペレータ・ノードで、olcne-api-serverサービスを停止します。

    sudo systemctl stop olcne-api-server.service
  2. Platform CLI、Platform API Server、ユーティリティ・パッケージを更新します:

    sudo dnf update olcnectl olcne-api-server olcne-utils
  3. 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」を参照してください。