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

1. バージョン 4.11 以前からアップグレードされた AWS クラスターには、CR アクティベーション が必要です。
2. バージョン 4.12 以前からアップグレードされた GCP および Azure クラスターでは、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、および VSphere です。

   5

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

   注記

   VMware vSphere は障害ドメインをサポートしていません。vSphere クラスターの場合、<platform_failure_domains> を空の failureDomains: パラメーターに置き換えます。

   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 ファイルの名前です。