5.2. ベアメタルコントロールプレーンノードの交換

手順

1. Bare Metal Operator が使用可能であることを確認します。

   $ oc get clusteroperator baremetal

   Copy to Clipboard Toggle word wrap

   出力例

   NAME        VERSION   AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   baremetal   4.20     True          False      False   3d15h

   Copy to Clipboard Toggle word wrap

2. 古い BareMetalHost オブジェクトおよび Machine オブジェクトを削除します。

   $ oc delete bmh -n openshift-machine-api <host_name>
   $ oc delete machine -n openshift-machine-api <machine_name>

   Copy to Clipboard Toggle word wrap

   <host_name> をホストの名前に、<machine_name> をマシンの名前に置き換えます。マシン名は CONSUMER フィールドの下に表示されます。

   BareMetalHost オブジェクトと Machine オブジェクトを削除すると、マシンコントローラーは Node オブジェクトを自動的に削除します。

3. 新しい BareMetalHost オブジェクトとシークレットを作成して BMC 認証情報を保存します。

   $ cat <<EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: control-plane-<num>-bmc-secret 

   1

   
     namespace: openshift-machine-api
   data:
     username: <base64_of_uid> 

   2

   
     password: <base64_of_pwd> 

   3

   
   type: Opaque
   ---
   apiVersion: metal3.io/v1alpha1
   kind: BareMetalHost
   metadata:
     name: control-plane-<num> 

   4

   
     namespace: openshift-machine-api
   spec:
     automatedCleaningMode: disabled
     bmc:
       address: <protocol>://<bmc_ip> 

   5

   
       credentialsName: control-plane-<num>-bmc-secret 

   6

   
     bootMACAddress: <NIC1_mac_address> 

   7

   
     bootMode: UEFI
     externallyProvisioned: false
     online: true
   EOF

   Copy to Clipboard Toggle word wrap

   1 4 6

   name および credentialsName フィールドの <num> は、ベアメタルノードのコントロールプレーン番号に置き換えます。

   2

   <base64_of_uid> を、ユーザー名の base64 文字列に置き換えます。

   3

   <base64_of_pwd> は、パスワードの base64 文字列に置き換えます。

   5

   <protocol> を redfish、redfish-virtualmedia、idrac-virtualmedia などの BMC プロトコルに置き換えます。<bmc_ip> は、ベアメタルノードのベースボード管理コントローラーの IP アドレスに置き換えます。その他の BMC 設定オプションは、関連情報 セクションの「BMC アドレス指定」を参照してください。

   7

   <NIC1_mac_address> は、ベアメタルノードの最初の NIC の MAC アドレスに置き換えます。

   検査が完了すると、BareMetalHost オブジェクトが作成され、プロビジョニングできるようになります。

4. 利用可能な BareMetalHost オブジェクトを表示します。

   $ oc get bmh -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                          STATE                    CONSUMER                   ONLINE   ERROR   AGE
   control-plane-1.example.com   available                control-plane-1            true             1h10m
   control-plane-2.example.com   externally provisioned   control-plane-2            true             4h53m
   control-plane-3.example.com   externally provisioned   control-plane-3            true             4h53m
   compute-1.example.com         provisioned              compute-1-ktmmx            true             4h53m
   compute-1.example.com         provisioned              compute-2-l2zmb            true             4h53m

   Copy to Clipboard Toggle word wrap

   コントロールプレーンノード用の MachineSet オブジェクトがないため、代わりに Machine オブジェクトを作成する必要があります。別のコントロールプレーン Machine オブジェクトから providerSpec をコピーできます。

5. Machine オブジェクトを作成します。

   $ cat <<EOF | oc apply -f -
   apiVersion: machine.openshift.io/v1beta1
   kind: Machine
   metadata:
     annotations:
       metal3.io/BareMetalHost: openshift-machine-api/control-plane-<num>
     labels:
       machine.openshift.io/cluster-api-cluster: control-plane-<num>
       machine.openshift.io/cluster-api-machine-role: master
       machine.openshift.io/cluster-api-machine-type: master
     name: control-plane-<num>
     namespace: openshift-machine-api
   spec:
     metadata: {}
     providerSpec:
       value:
         apiVersion: baremetal.cluster.k8s.io/v1alpha1
         customDeploy:
           method: install_coreos
         hostSelector: {}
         image:
           checksum: ""
           url: ""
         kind: BareMetalMachineProviderSpec
         metadata:
           creationTimestamp: null
         userData:
           name: master-user-data-managed
   EOF

   Copy to Clipboard Toggle word wrap

   <num> は、annotations、labels、name フィールドのベアメタルノードのコントロールプレーン番号に置き換えます。

6. BareMetalHost オブジェクトを表示するには、次のコマンドを実行します。

   $ oc get bmh -A

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                          STATE                    CONSUMER                   ONLINE   ERROR   AGE
   control-plane-1.example.com   provisioned              control-plane-1            true             2h53m
   control-plane-2.example.com   externally provisioned   control-plane-2            true             5h53m
   control-plane-3.example.com   externally provisioned   control-plane-3            true             5h53m
   compute-1.example.com         provisioned              compute-1-ktmmx            true             5h53m
   compute-2.example.com         provisioned              compute-2-l2zmb            true             5h53m

   Copy to Clipboard Toggle word wrap

7. RHCOS のインストール後、BareMetalHost がクラスターに追加されていることを確認します。

   $ oc get nodes

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                           STATUS      ROLES     AGE   VERSION
   control-plane-1.example.com    available   master    4m2s  v1.33.4
   control-plane-2.example.com    available   master    141m  v1.33.4
   control-plane-3.example.com    available   master    141m  v1.33.4
   compute-1.example.com          available   worker    87m   v1.33.4
   compute-2.example.com          available   worker    87m   v1.33.4

   Copy to Clipboard Toggle word wrap

   注記

   新しいコントロールプレーンノードの交換後、新しいノードで実行されている etcd Pod は crashloopback ステータスになります。詳細は、関連情報 セクションの「正常でない etcd メンバーの置き換え」を参照してください。