11.2.2.2. Machine API リソースを移行して Cluster API を使用する

手順

1. 次のコマンドを実行して、Cluster API リソースに移行する Machine API リソースを特定します。

   $ oc get <resource_kind> -n openshift-machine-api

   ここで、<resource_kind> は次のいずれかの値になります。

   machine.machine.openshift.io

   コンピュートまたはコントロールプレーンマシンのリソースの種類の完全修飾名。

   machineset.machine.openshift.io

   コンピュートマシンセットのリソースの種類の完全修飾名。

2. 次のコマンドを実行してリソース仕様を編集します。

   $ oc edit <resource_kind>/<resource_name> -n openshift-machine-api

   ここでは、以下のようになります。

   <resource_kind>

   machine.machine.openshift.io を持つコンピュートマシン、または machineset.machine.openshift.io で設定されたコンピュートマシンを指定します。

   <resource_name>

   Cluster API リソースに移行する Machine API リソースの名前を指定します。

3. リソース仕様で、spec.authoritativeAPI フィールドの値を更新します。

   apiVersion: machine.openshift.io/v1beta1
   kind: <resource_kind>
   metadata:
     name: <resource_name>
     [...]
   spec:
     authoritativeAPI: ClusterAPI
     [...]
   status:
     authoritativeAPI: MachineAPI
     [...]

   ここでは、以下のようになります。

   kind

   移行するリソースの種類を指定します。たとえば、コンピュートマシンセットのリソースの種類は MachineSet であり、コンピュートマシンのリソースの種類は Machine です。

   metadata.name

   移行するリソースの名前を指定します。

   spec.authoritativeAPI

   このリソースが使用する権威ある API を指定します。たとえば、Machine API リソースの Cluster API への移行を開始するには、ClusterAPI を指定します。

   ステータス.authoritativeAPI

   現在の権威ある API の値を指定します。この値は、現在このリソースを管理している API を示します。仕様のこの部分の値は変更しないでください。

   重要

   spec.authoritativeAPI フィールドの値を更新する際は、他の値を変更しないでください。同期コントローラーが spec.authoritativeAPI フィールドの更新を処理する前に、他のコントローラーが他の値の更新を処理する可能性があるため、他の値を変更すると予期しない動作が発生する可能性があります。

   詳細は、リソース設定の変更時に予期しない動作が発生するを参照してください。