4 リリース1.5へのアップグレード
重要:
このドキュメントで説明されているソフトウェアは、Extended SupportまたはSustaining Supportにあります。 詳細は、「Oracleオープン・ソース・サポート・ポリシー」を参照してください。
このドキュメントに記載されているソフトウェアをできるだけ早くアップグレードすることをお勧めします。
この項では、リリース1.4からリリース1.5にOracle Cloud Native Environmentをアップグレードする方法について説明します。
Oracle Cloud Native EnvironmentパッケージおよびKubernetesクラスタをリリース1.5にアップグレードすると、このリリースの新機能を使用できます。
環境をリリース1.4からリリース1.5にアップグレードするには、この章の各ステップを実行します。
ソフトウェア・パッケージのソースの変更
この項では、Oracle Cloud Native Environmentソフトウェアをアップグレードするオペレーティング・システムのソフトウェア・パッケージのロケーションの設定について説明します。
Oracle Linux 8
ノードのオペレーティング・システムがOracle Linux 8の場合は、このセクションの情報を使用してパッケージ・ソースを更新します。
システムがULNを使用するように登録されている場合は、ULN webインタフェースを使用して各システムをol8_x86_64_olcne15チャネルにサブスクライブします。 各システムを次のチャネルからサブスクライブ解除してください:
-
ol8_x86_64_olcne14 -
ol8_x86_64_olcne13 -
ol8_x86_64_olcne12
システム更新にOracle Linux yumサーバーを使用している場合、各ノードでoracle-olcne-release-el8リリース・パッケージを更新します。 ol8_olcne15リポジトリを有効にし、以前のリリースのリポジトリを無効にします。 これらを次に示します。
-
ol8_olcne14 -
ol8_olcne13 -
ol8_olcne12
各ノードで次を実行します。
sudo dnf update oracle-olcne-release-el8
sudo dnf config-manager --enable ol8_olcne15
sudo dnf config-manager --disable ol8_olcne14 ol8_olcne13 ol8_olcne12Oracle Linux 7
ノードのオペレーティング・システムがOracle Linux 7の場合は、このセクションの情報を使用してパッケージ・ソースを更新します。
以前のリリースのULNチャネルまたはOracle Linux yumサーバー・リポジトリを無効にし、リリース1.5のリポジトリを有効にします。
システムがULNを使用するように登録されている場合は、ULN webインタフェースを使用してシステムをol7_x86_64_olcne15チャネルにサブスクライブします。 必ず、次のチャネルから各システムを登録解除してください。
-
ol7_x86_64_olcne14 -
ol7_x86_64_olcne13 -
ol7_x86_64_olcne12 -
ol7_x86_64_olcne11 -
ol7_x86_64_olcne -
ol7_x86_64_developer
システムの更新にOracle Linux yumサーバーを使用する場合は、各ノードでoracle-olcne-release-el7リリース・パッケージを更新します。 ol7_olcne15リポジトリを有効にして、次のリポジトリを無効にします:
-
ol7_olcne14 -
ol7_olcne13 -
ol7_olcne12 -
ol7_olcne11 -
ol7_olcne -
ol7_developer
各ノードで次を実行します。
sudo yum update oracle-olcne-release-el7
sudo yum-config-manager --enable ol7_olcne15
sudo yum-config-manager --disable ol7_olcne14 ol7_olcne13 ol7_olcne12 ol7_olcne11 ol7_olcne ol7_developerオペレータ・ノードのアップグレード
新しいOracle Cloud Native Environmentソフトウェア・パッケージでオペレータ・ノードをアップグレードします。
Oracle Linux 8のオペレータ・ノードをアップグレードするには:
-
オペレータ・ノードで、
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
Oracle Linux 7のオペレータ・ノードをアップグレードするには:
-
オペレータ・ノードで、
olcne-api-serverサービスを停止します。sudo systemctl stop olcne-api-server.service
-
Platform CLI、Platform API Server、ユーティリティ・パッケージを更新します:
sudo yum 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コマンドを使用して、環境内の各ノードでプラットフォーム・エージェントをアップグレードします。 この例では、myenvironment環境のすべてのノードでPlatform Agentをアップグレードします。
olcnectl environment update olcne \ --environment-name myenvironment
プラットフォーム・エージェントがアップグレードされ、各ノードでサービスが再起動されます。
Kubernetesクラスタのアップグレード
クラスタをKubernetesリリース1.24.15にアップグレードします。
オペレータ・ノードで、olcnectl module updateコマンドを使用して、Oracle Cloud Native Environmentリリース1.5で使用可能な最新のKubernetesリリースにアップグレードします。 この例では、myenvironment環境のmyclusterという名前のKubernetesモジュールをKubernetesリリース1.24.15にアップグレードします。
olcnectl module update \
--environment-name myenvironment \
--name mycluster \
--kube-version 1.24.15 --kube-versionオプションでは、アップグレード先のリリースを指定します。 この例では、リリース番号1.24.15を使用します。
重要:
必ず最新のKubernetesリリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.5の最新のKubernetesリリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
クラスタ内の各ノードが最新のKubernetesリリースにアップグレードされるときに、クラスタの状態が検証され、アップグレードが完了します。
Istioのアップグレード
Istioモジュールがインストールされている場合は、アップグレードして、サポートするPrometheusおよびGrafanaモジュールをアップグレードする必要があります。
重要:
この項の各コンポーネントの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.5の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
Istioをアップグレードするには:
-
オペレータ・ノードで、
olcnectl module updateコマンドを使用して、Oracle Cloud Native Environment Release 1.5で使用可能な最新のIstioリリースにアップグレードします。 この例では、myenvironment環境のmyistioという名前のIstioモジュールをIstioリリース1.15.7にアップグレードします。olcnectl module update \ --environment-name myenvironment \ --name myistio \ --istio-version 1.15.7--istio-versionオプションでは、アップグレード先のリリースを指定します。 この例では、リリース番号1.15.7を使用します。Istioリリース1.15.7にアップグレードすると、各Istioリリースをリリース1.15.7まで繰り返し処理します。 クラスタ内の各ノードが次のIstioリリースにアップグレードされるときに、クラスタの状態が検証されます。 クラスタが正常の場合、すべてのノードが最新のIstioリリースにアップグレードされるまで、バックアップのサイクル、次のリリースへのアップグレード、クラスタ検証が再度開始されます。
-
Oracle Cloud Native Environmentリリース1.5で使用可能な最新のPrometheusリリースにアップグレードします。 この例では、
myenvironment環境のprometheusという名前のPrometheusモジュール(デフォルトではIstioモジュールによって割り当てられた名前)をPrometheusリリース2.31.1にアップグレードします。olcnectl module update \ --environment-name myenvironment \ --name prometheus \ --prometheus-version 2.31.1 -
Oracle Cloud Native Environmentリリース1.5で使用可能な最新のGrafanaリリースにアップグレードします。 この例では、
myenvironment環境のgrafanaという名前のGrafanaモジュール(デフォルトではIstioモジュールによって割り当てられた名前)をGrafanaリリース7.5.15にアップグレードします。olcnectl module update \ --environment-name myenvironment \ --name grafana \ --grafana-version 7.5.15
Oracle Cloud Infrastructureコンテナ・ストレージ・インタフェース・モジュールのアップグレード
Oracle Cloud Infrastructure Container Storage Interfaceモジュールがインストールされている場合は、これもアップグレードする必要があります。 Oracle Cloud Infrastructure Container Storage Interfaceモジュール(oci-csi)は、リリース1.5のOracle Cloud Infrastructure Cloud Controller Managerモジュール(oci-ccm)に変更されました。 このモジュールの機能が改善され、Oracle Cloud Infrastructureロード・バランサを作成および管理する機能が追加されました。
Oracle Cloud Native Environment Platform API Serverのアップグレード中、モジュールはoci-csiからoci-ccmに自動的に移行されますが、モジュールを正しく構成するために一部のモジュール・オプションを更新する必要があります。
oci-ccmモジュールをアップグレードするには、オペレータ・ノードでolcnectl module updateコマンドを使用します。 この例では、myenvironment環境のmyociという名前のモジュールをoci-ccmモジュール・リリース1.24.0にアップグレード
olcnectl module update \
--environment-name myenvironment \
--name myoci \
--oci-ccm-version 1.24.0 \
--oci-container-registry "" \
--ccm-container-registry "" --oci-ccm-versionオプションは、アップグレードするリリースを指定します。 この例では、リリース番号1.24.0を使用します。
重要:
Oracle Cloud Infrastructure Cloud Controller Managerモジュールの最新リリースにアップグレードしてください。 Oracle Cloud Native Environmentリリース1.5の最新リリースのバージョン番号を取得するには、「リリース・ノート」を参照してください。
レジストリ・オプション--oci-container-registryおよび--ccm-container-registryの場合、この例ではパブリック・レジストリが使用されていると想定しています。したがって、どちらのオプションも空の文字列("")に設定され、プラットフォームAPIサーバーがOracle Cloud Infrastructure Cloud Controller Managerコンテナ・イメージのプル元の正しいパブリック・コンテナ・レジストリを自動的に構成できるようにします。 ただし、プライベート・レジストリを使用しており、インストール・プロセス中に--oci-container-registryおよび--ccm-container-registryの値をすでに設定している場合は、これらのオプションを指定する必要はありません。
ヒント:
Oracle Cloud Infrastructure Cloud Controller Managerモジュールを使用してKubernetesアプリケーション・ロード・バランサを設定する場合は、モジュールにネットワーク情報を追加する必要があります。 必要なネットワーク設定およびモジュールの更新方法については、「アプリケーション・ロード・バランサ」を参照してください。