管理クラスタ上のサービスのアップグレード

管理クラスタは、アプライアンスの管理機能およびユーザー向け機能を提供するサービスを実行します。これらをフル・ラックのアップグレード・ワークフローの外部でアップグレードするためのコマンドが提供されています。

Kubernetesクラスタのアップグレード

Kubernetesコンテナ・オーケストレーション環境のアップグレードは、ホストOSと切り離されています。 1つのコマンドを使用すると、すべてのKubernetesパッケージ(kubeadm、kubectl、kubeletなど)が3つの管理ノードおよびすべてのコンピュート・ノードでアップグレードされます。依存性の理由から、管理ノード・ホストOSの後にKubernetesをアップグレードする必要があります。このアップグレードには、Kubernetesクラスタ内で実行されているマイクロサービスは含まれません。

「サービスWeb UI」の使用

ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。
「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。
「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。

「要求の作成」ウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: ラックのアップグレード。
アップグレード・リクエスト・パラメータを入力します:
- アクション: アップグレードまたはパッチ操作を実行するには、「適用」を選択します。
- タイプ: アップグレードの場合は、「ISO」を選択します。「The ULN」オプションは、パッチ適用に適用されます。
- コンポーネント: Kubernetesクラスタの場合は、Kubernetesを選択します。
- クオリファイア: Kubernetesクラスタをアップグレードする場合、このパラメータは必要ありません。
- 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。
- 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。
「要求の作成」をクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
アップグレード・プロセスがエラーなしで完了したことを確認します。

詳細は、「ジョブ・フレームワークの参照」を参照してください。

「サービスCLI」の使用

アップグレード・コマンドを入力します。

PCA-ADMIN> upgradeRack type=ISO action=APPLY component=KUBERNETES
JobId: 6b796a4a-89ac-4fcc-a5c7-efb0eb9dceac
Data: Service request has been submitted. Upgrade Job Id = 1737620352375-kubernetes-660839 Upgrade Request Id = UWS-dd3cdaf7-5302-4b57-8858-caff924c2dcf

ジョブIDを使用して、アップグレード・プロセスのステータスを確認します。

PCA-ADMIN> getUpgradeJob upgradeJobId=1737620352375-kubernetes-660839
Data:
  Upgrade Request Id = UWS-dd3cdaf7-5302-4b57-8858-caff924c2dcf
  Name = kubernetes
  Pid = 660839
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_kubernetes_cluster_2025_01_23-08.19.12.log
  Arguments = {"component_names":null,"diagnostics":false,"display_task_plan":false,"dry_run_tasks":false,"expected_iso_checksum":null,"fail_halt":false,"fail_upgrade":null,"image_location":null,"online_upgrade":null,"precheck_status":false,"repo_config_override":null,"result_override":null,"task_time":0,"test_run":false,"upgrade":false,"upgrade_to":null,"user_uln_base_url":null,"verify_only":false,"host_ip":null,"log_level":null,"switch_type":null,"epld_image_location":null,"checksum":null,"composition_id":null,"request_id":"UWS-dd3cdaf7-5302-4b57-8858-caff924c2dcf","uln":null,"patch":"false"}
  Status = Passed
  Execution Time(sec) = 249
[...]

アップグレード・プロセスがエラーなしで完了したことを確認します。

詳細は、「ジョブ・フレームワークの参照」を参照してください。

マイクロサービスのアップグレード

マイクロサービス・アップグレードは、プラットフォーム・レイヤーの内部サービス、およびインフラストラクチャ・サービス・レイヤーを通じて公開される管理レベルとユーザー・レベルのサービスの両方をカバーします。コンテナ化されたマイクロサービスには、独自のアップグレード・メカニズムがあります。新しいHelmデプロイメント・チャートおよびコンテナ・イメージがISOコンテンツで見つかった場合、サービスはアップグレードされます。アップグレード・プロセス中に新しいデプロイメント・チャートが検出されると、サービスを実行しているポッドが新しいコンテナ・イメージで再起動されます。

ノート:

特定の状況では、オプションのJSON文字列をコマンドに追加することで、特定のプラットフォーム・サービスを個別にアップグレードできます。このオプションは、Oracleで明示的な手順が提供されないかぎり使用しないでください。

「サービスWeb UI」の使用

ナビゲーション・メニューで、「メンテナンス」セクションに移動し、「アップグレード計画」をクリックします。ここでは、現行およびターゲット・コンポーネントのバージョンの概要を示します。
「アップグレード&パッチ適用」をクリックして、「アップグレード・ジョブ」ページを表示します。
「アップグレード・ジョブ」ページの右上隅にある「アップグレードまたはパッチの作成」をクリックします。

「要求の作成」ウィンドウが表示されます。リクエスト・タイプとして「アップグレード」を選択します。
適切なアップグレード・リクエスト・タイプを選択: ラックのアップグレード。
アップグレード・リクエスト・パラメータを入力します:
- アクション: アップグレードまたはパッチ操作を実行するには、「適用」を選択します。
- タイプ: アップグレードの場合は、「ISO」を選択します。「The ULN」オプションは、パッチ適用に適用されます。
- コンポーネント: プラットフォームおよびインフラストラクチャ・マイクロサービスの場合は、「プラットフォーム」を選択します。
- クオリファイア: マイクロサービスをアップグレードする場合、このパラメータは必要ありません。
- 検証のみ: 検証専用モードで操作を実行するには、このオプションを有効にします。
- 強制: 操作を強制するには、このオプションを有効にします。 Oracleによって指示された場合のみ使用します。
「要求の作成」をクリックします。

新しいアップグレード・リクエストが「アップグレード・ジョブ」表に表示されます。
アップグレード・プロセスがエラーなしで完了したことを確認します。

詳細は、「ジョブ・フレームワークの参照」を参照してください。

「サービスCLI」の使用

アップグレード・コマンドを入力します。

PCA-ADMIN> upgradeRack type=ISO action=APPLY component=PLATFORM
JobId: 30116885-57e3-4737-b6a2-9f429f084fb5
Data: Service request has been submitted. Upgrade Job Id = 1737620370636-platform-666460 Upgrade Request Id = UWS-26312768-855d-4f31-90b9-cbb0559d1d7f

ジョブIDを使用して、アップグレード・プロセスのステータスを確認します。

PCA-ADMIN> getUpgradeJob upgradeJobId=1737620370636-platform-666460
Data:
  Upgrade Request Id = UWS-26312768-855d-4f31-90b9-cbb0559d1d7f
  Name = platform
  Pid = 666460
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_platform_services_2025_01_23-08.19.30.log
  Arguments = {"component_names":null,"diagnostics":false,"display_task_plan":false,"dry_run_tasks":false,"expected_iso_checksum":null,"fail_halt":false,"fail_upgrade":null,"image_location":null,"online_upgrade":null,"precheck_status":false,"repo_config_override":null,"result_override":null,"task_time":0,"test_run":false,"upgrade":false,"upgrade_to":null,"user_uln_base_url":null,"verify_only":false,"host_ip":null,"log_level":null,"switch_type":null,"epld_image_location":null,"checksum":null,"composition_id":null,"request_id":"UWS-26312768-855d-4f31-90b9-cbb0559d1d7f","uln":null,"patch":"false"}
  Status = Passed
  Execution Time(sec) = 536
[...]

アップグレード・プロセスがエラーなしで完了したことを確認します。

詳細は、「ジョブ・フレームワークの参照」を参照してください。