12.2. コントロールプレーンマシンセットの概要

1. バージョン 4.11 以前からアップグレードされた AWS クラスターには、CR アクティベーション が必要です。
2. バージョン 4.12 以前からアップグレードされた GCP および Azure クラスターでは、CR アクティベーション が必要です。
3. バージョン 4.13 以前からアップグレードされた Nutanix クラスターおよび RHOSP クラスターには CR アクティベーション が必要です。
4. バージョン 4.15 以前からアップグレードされた vSphere クラスターには、CR アクティベーション が必要です。

手順

1. 次のコマンドを実行して、CR の設定を表示します。

   $ oc --namespace openshift-machine-api edit controlplanemachineset.machine.openshift.io cluster

2. クラスター設定に不適切なフィールドの値を変更します。

3. 設定が正しい場合は、.spec.state フィールドを Active に設定し、変更を保存して CR をアクティブにします。

   重要

   CR を有効にするには、CR 設定の更新に使用するのと同じ oc edit セッションで .spec.state フィールドを Active に変更する必要があります。CR が Inactive のままの状態で保存された場合、コントロールプレーンマシンセットジェネレーターは CR を元の設定にリセットします。

手順

1. 次のテンプレートを使用して YAML ファイルを作成します。

   コントロールプレーンマシンセットの CR YAML ファイルテンプレート

   apiVersion: machine.openshift.io/v1
   kind: ControlPlaneMachineSet
   metadata:
     name: cluster
     namespace: openshift-machine-api
   spec:
     replicas: 3
     selector:
       matchLabels:
         machine.openshift.io/cluster-api-cluster: <cluster_id> 1
         machine.openshift.io/cluster-api-machine-role: master
         machine.openshift.io/cluster-api-machine-type: master
     state: Active 2
     strategy:
       type: RollingUpdate 3
     template:
       machineType: machines_v1beta1_machine_openshift_io
       machines_v1beta1_machine_openshift_io:
         failureDomains:
           platform: <platform> 4
           <platform_failure_domains> 5
         metadata:
           labels:
             machine.openshift.io/cluster-api-cluster: <cluster_id> 6
             machine.openshift.io/cluster-api-machine-role: master
             machine.openshift.io/cluster-api-machine-type: master
         spec:
           providerSpec:
             value:
               <platform_provider_spec> 7

   1

   クラスターのプロビジョニング時に設定したクラスター ID を基にするインフラストラクチャー ID を指定します。ControlPlaneMachineSet CR を作成するときに、この値を指定する必要があります。OpenShift CLI (oc) がインストールされている場合は、以下のコマンドを実行してインフラストラクチャー ID を取得できます。

   $ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster

   2

   Operator の状態を指定します。状態が Inactive の場合、Operator は操作できません。値を Active に設定することで、Operator をアクティブ化できます。

   重要

   CR をアクティブ化する前に、その設定がクラスター要件に対して正しいことを確認する必要があります。

   3

   クラスターの更新戦略を指定します。有効な値は OnDelete および RollingUpdate です。デフォルト値は RollingUpdate です。更新戦略の詳細は、「コントロールプレーン設定の更新」を参照してください。

   4

   クラウドプロバイダーのプラットフォーム名を指定します。有効な値は、AWS、Azure、GCP、Nutanix、VSphere、および OpenStack です。

   5

   クラスターの <platform_failure_domains> 設定を追加します。このセクションのフォーマットと値はプロバイダー固有です。詳細については、クラウドプロバイダーの障害ドメイン設定サンプルを参照してください。

   6

   インフラストラクチャー ID を指定します。

   7

   クラスターの <platform_provider_spec> 設定を追加します。このセクションのフォーマットと値はプロバイダー固有です。詳細については、クラウドプロバイダーのサンプルプロバイダー仕様を参照してください。

2. コントロールプレーンマシンセット CR のサンプル YAML を参照し、クラスター設定に適した値をファイルに入力します。
3. クラウドプロバイダーのサンプル障害ドメイン設定とサンプルプロバイダー仕様を参照し、ファイルのこれらのセクションを適切な値で更新します。
4. 設定が正しい場合は、.spec.state フィールドを Active に設定し、変更を保存して CR をアクティブにします。

5. 次のコマンドを実行して、YAML ファイルから CR を作成します。

   $ oc create -f <control_plane_machine_set>.yaml

   <control_plane_machine_set> は、CR 設定を含む YAML ファイルの名前です。