第2章 クラスターの更新の準備

手順

1. 次のコマンドを実行して、削除する必要のあるすべての Gateway API CRD をリスト表示します。

   $ oc get crd | grep -F -e gateway.networking.k8s.io -e gateway.networking.x-k8s.io

   出力例

   gatewayclasses.gateway.networking.k8s.io
   gateways.gateway.networking.k8s.io
   grpcroutes.gateway.networking.k8s.io
   httproutes.gateway.networking.k8s.io
   referencegrants.gateway.networking.k8s.io

2. 以下のコマンドを実行して、直前の手順の Gateway API CRD を削除します。

   $ oc delete crd gatewayclasses.networking.k8s.io && \
   oc delete crd gateways.networking.k8s.io && \
   oc delete crd grpcroutes.gateway.networking.k8s.io && \
   oc delete crd httproutes.gateway.networking.k8s.io && \
   oc delete crd referencesgrants.gateway.networking.k8s.io

   重要

   CRD を削除すると、それらに依存するすべてのカスタムリソースが削除され、データが失われる可能性があります。Gateway API CRD を削除する前に、必要なデータのバックアップを作成します。Gateway API CRD のライフサイクルをこれまで管理していたコントローラーは、すべて適切に動作しなくなります。Ingress Operator と組み合わせて強制的に使用し、Gateway API CRD を管理しようとすると、クラスターの更新が成功しない可能性があります。

3. 次のコマンドを実行して、サポートされている Gateway API CRD を取得します。

   $ oc apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.2.1/standard-install.yaml

   警告

   この手順は、CRD を削除せずに実行できます。CRD への更新により、カスタムリソースによって使用されるフィールドが削除されると、データが失われる可能性があります。フィールドを再追加するバージョンに CRD を再度更新すると、削除されたはずのデータが再び表示される可能性があります。OpenShift Container Platform 4.21 でサポートされていない特定の Gateway API CRD バージョンに依存するサードパーティー製コントローラーは、その CRD を Red Hat がサポートするバージョンに更新すると動作しなくなります。

   OpenShift Container Platform の実装および dead fields の問題の詳細は、OpenShift Container Platform の Gateway API 実装 を参照してください。

手順

1. 使用するカスタムワーカー MCP ごとに、次の例のように MCP YAML ファイルを作成します。

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfigPool
   metadata:
     name: worker-0
     labels:
       machineconfiguration.openshift.io/role: worker-0
   spec:
     machineConfigSelector:
       matchExpressions:
         - key: machineconfiguration.openshift.io/role
           operator: In
           values: [ worker, worker-0 ]
     paused: false
     maxUnavailable: 100%
     nodeSelector:
       matchLabels:
         node-role.kubernetes.io/worker-0: ""

   以下の設定がされていることを確認してください。

   • maxUnavailable: この値を 100% に設定します。この設定により、この特定の MCP 内のすべてのノードが初期デプロイメント時に同時に更新されることが保証されます。デフォルトでは、maxUnavailable は 1 に設定されており、初期デプロイメント時にこの特定の MCP 内のすべてのノードが順次更新されます。
   • nodeSelector: node-role.kubernetes.io/worker-0 のような一意のラベルを定義して、特定のノードをこのプールにバインドします。

   • paused: インストール後に PerformanceProfile などの追加の Day 2 設定を適用する予定がある場合は、この値を true に設定してください。MCP が一時停止している間でも、Day 2 のすべての設定を適用できます。それらはキューに追加され、ノードの一時停止を解除したときに適用されます。追加の設定が不要な場合は、この値を false に設定してください。

     注記

     ベアメタルサーバーの場合、再起動には数分かかる場合があります。

2. YAML ファイルをインストールプログラムによって生成されたディレクトリーに配置してください。プロビジョニングフェーズ中、または参加直後に、ワーカーノードに node-role.kubernetes.io/worker-0 のような正しいラベルが割り当てられていることを確認してください。

   注記

   適切なラベル付けを行うことで、ノードがデフォルトのワーカープールではなく、正しいカスタム MCP に割り当てられることが保証されます。

3. オプション: 追加の設定を適用するために paused パラメーターを true に設定する場合は、以下の手順を実行してください。

   1. Day 2 の設定を適用してください。

   2. MCP の一時停止を解除して設定フェーズを開始し、必要に応じて再起動してください。API にアクセスして oc コマンドを実行するには、クラスターをデプロイする必要があります。

      $ oc patch mcp/worker-0 --patch '{"spec":{"paused":false}}' --type=merge

      出力例

      machineconfigpool.machineconfiguration.openshift.io/worker-0 patched

      注記

      paused パラメーターを true に設定しなかった場合、設定は順次適用され、必要に応じて再起動されます。

4. MCP が正常に更新されたことを確認してください。

   $ oc get machineconfigpools

   出力例

   NAME       CONFIG                                           UPDATED   UPDATING   DEGRADED   MACHINECOUNT   READYMACHINECOUNT   UPDATEDMACHINECOUNT   DEGRADEDMACHINECOUNT   AGE
   master     rendered-master-b0bb90c4921860f2a5d8a2f8137c1867 True      False      False      3              3                   3                     0                      97m
   worker-0   rendered-worker-config-new                       False     True       False      10             0                   0                     0                      5m

5. すべての MCP が UPDATED=true に設定されている場合、ワークロード要件に基づいて適切な maxUnavailable で MCP を更新します。これにより、ユーザーがワークロードをクラスターにデプロイする際のクラスターの安定性と高可用性が確保されます。たとえば、以下のコマンドを実行して maxUnavailable を 1 に設定します。

   $ oc patch mcp/worker-0 --patch '{"spec":{"maxUnavailable":1}}' --type=merge

   出力例

   machineconfigpool.machineconfiguration.openshift.io/worker-0 patched