9.2. ClusterInstance CR を使用してノードを削除する

手順

1. ClusterInstance CR を更新して、ノードの BareMetalHost リソースに bmac.agent-install.openshift.io/remove-agent-and-node-on-delete=true アノテーションを追加し、変更内容を Git リポジトリーにプッシュします。

   apiVersion: siteconfig.open-cluster-management.io/v1alpha1
   kind: ClusterInstance
   metadata:
     name: "example-cluster"
     namespace: "example-cluster"
   spec:
     # ...
     nodes:
       - hostName: "worker-node2.example.com"
         role: "worker"
         extraAnnotations:
           BareMetalHost:
             bmac.agent-install.openshift.io/remove-agent-and-node-on-delete: "true"
   # ...

2. 次のコマンドを実行して、BareMetalHost オブジェクトにアノテーションが付けられていることを確認します。

   $ oc get bmh -n <cluster_namespace> <bmh_name> -ojsonpath='{.metadata}' | jq -r '.annotations["bmac.agent-install.openshift.io/remove-agent-and-node-on-delete"]'

   出力例

   true

3. ClusterInstance CR の pruneManifests フィールドを設定して、対象の BareMetalHost リソースを削除することにより、BareMetalHost CR を削除します。

   apiVersion: siteconfig.open-cluster-management.io/v1alpha1
   kind: ClusterInstance
   metadata:
     name: "example-cluster"
     namespace: "example-cluster"
   spec:
     # ...
     nodes:
       - hostName: "worker-node2.example.com"
         role: "worker"
         pruneManifests:
           - apiVersion: metal3.io/v1alpha1
             kind: BareMetalHost
   # ...

4. 変更を Git リポジトリーにプッシュし、プロビジョニング解除が開始するまで待ちます。BareMetalHost CR のステータスが deprovisioning に変更されるはずです。BareMetalHost のプロビジョニング解除が完了し、完全に削除されるまで待ちます。

検証

1. 次のコマンドを実行して、ワーカーノードの BareMetalHost および Agent CR がハブクラスターから削除されていることを確認します。

   $ oc get bmh -n <cluster_namespace>

   $ oc get agent -n <cluster_namespace>

2. 次のコマンドを実行して、スポーククラスターからノードレコードが削除されたことを確認します。

   $ oc get nodes

   注記

   シークレットを操作している場合は、シークレットを削除するのが早すぎると、ArgoCD が削除後に再同期を完了するためにシークレットを必要とするため、問題が発生する可能性があります。現在の ArgoCD 同期が完了したら、ノードのクリーンアップ後にのみシークレットを削除します。

3. BareMetalHost オブジェクトが正常に削除されたら、ClusterInstance CR の spec.nodes セクションからワーカーノードの定義を削除し、変更内容を Git リポジトリーにプッシュします。