ワークロード クラスタのマシン健全性チェックの管理
このトピックでは、Tanzu Kubernetes Grid によって作成されたワークロード クラスタの MachineHealthCheck オブジェクトを作成、更新、取得、および削除するために Tanzu コマンド ライン インターフェイス (CLI) を使用する方法について説明します。
詳細については、「Tanzu CLI コマンド リファレンス」の「tanzu cluster machinehealthcheck」を参照してください。
注制御プレーン ノードとワークロード ノードの両方でマシン健全性チェックをサポートするため、Tanzu CLI v1.6 以降は、
tanzu cluster machinehealthcheck set/get/deleteコマンドを、tanzu cluster machinehealthcheck control-plane set/get/deleteおよびtanzu cluster machinehealthcheck node set/get/deleteコマンドに置き換えます。tanzu cluster machinehealthcheck set/get/deleteコマンドは廃止され、今後のリリースで削除される予定です。
MachineHealthCheck について
MachineHealthCheck は、マシンの健全性監視と自動修復を提供するコントローラです。これは、すべての管理クラスタおよびワークロード クラスタ内の制御プレーン ノードとワーカー ノードの両方に対して自動的に有効になります。クラスタを展開するときにコントローラが有効になっている場合、Tanzu Kubernetes Grid は、クラスタ内に 2 つのデフォルトの MachineHealthCheck オブジェクトを作成します。1 つは制御プレーン ノード用、もう 1 つはワーカー ノード用です。これらのオブジェクトは、クラスタと同じ名前空間に作成されます。
コントローラを無効にした場合、「MachineHealthCheck オブジェクトの作成または更新」に記載されているコマンドを使用して、コントローラを再度有効にすることができます。これらのコマンドを使用して、既存の MachineHealthCheck オブジェクトを更新することもできます。
MachineHealthCheck オブジェクトの作成または更新
デフォルトの MachineHealthCheck オブジェクトを作成するには、次の手順を実行します。
-
クラスタの制御プレーンの場合は、次のコマンドを実行します。
tanzu cluster machinehealthcheck control-plane set CLUSTER-NAME --mhc-name MHC-NAME -
クラスタのワーカー ノードの場合は、次のコマンドを実行します。
tanzu cluster machinehealthcheck node set CLUSTER-NAME --mhc-name MHC-NAME
ここで、
CLUSTER-NAMEはターゲット クラスタの名前です。MHC-NAMEは、MachineHealthCheckオブジェクトに対して選択した名前です。指定しない場合、名前はCLUSTER-NAMEに設定されます。これらのコマンドを両方とも実行している場合は、--mhc-nameを指定する必要があります。
上記のコマンドを使用して、カスタマイズされた MachineHealthCheck オブジェクトを作成したり、既存の MachineHealthCheck オブジェクトを更新したりすることもできます。MachineHealthCheck オブジェクトをカスタマイズまたは更新するには、次のフラグを 1 つ以上指定できます。
-
--match-labels：このオプションは、ラベルのキーと値によってマシンをフィルタリングします。1 つまたは複数のラベルの制約を指定できます。MachineHealthCheckオブジェクトは、指定された制約を満たすすべてのマシンに適用されます。キーと値のペアの形式を次のように設定します。tanzu cluster machinehealthcheck control-plane set CLUSTER-NAME --mhc-name MHC-NAME --match-labels "key1:value1,key2:value2" tanzu cluster machinehealthcheck node set CLUSTER-NAME --mhc-name MHC-NAME --match-labels "key1:value1,key2:value2" -
--node-startup-timeout：このオプションは、MachineHealthCheckコントローラが、マシンのクラスタへの参加を待機してから、マシンの健全性を良好でないと判断するまでの時間を制御します。たとえば、次のコマンドは、--node-startup-timeoutオプションを21mに設定します。tanzu cluster machinehealthcheck control-plane set my-cluster --mhc-name my-control-plane-mhc --node-startup-timeout 21m tanzu cluster machinehealthcheck node set my-cluster --mhc-name my-worker-mhc --node-startup-timeout 21mマシンが指定時間内にクラスタへ参加できなかった場合、
MachineHealthCheckコントローラによってマシンが再作成されます。 -
--unhealthy-conditions：このオプションは、Ready、MemoryPressure、DiskPressure、PIDPressure、およびNetworkUnavailable条件を設定できます。MachineHealthCheckコントローラは、制御プレーン ノードとワーカー ノードの健全性を監視するために設定した条件を使用します。条件のステータスを設定するには、True、False、またはUnknownを使用します。例：tanzu cluster machinehealthcheck control-plane set my-cluster --mhc-name my-control-plane-mhc --unhealthy-conditions "Ready:False:5m,Ready:Unknown:5m" tanzu cluster machinehealthcheck node set my-cluster --mhc-name my-worker-mhc --unhealthy-conditions "Ready:False:5m,Ready:Unknown:5m"上記の例では、
Ready条件をFalse:5mおよびUnknown:5mに設定しています。マシンが5m以上UnknownまたはFalse状態のままになると、MachineHealthCheckコントローラはマシンの健全性が良好でないと見なし、マシンを再作成します。
MachineHealthCheck オブジェクトの取得
MachineHealthCheck オブジェクトを取得するには、次の手順を実行します。
-
ターゲット クラスタの制御プレーンの場合は、次のコマンドを実行します。
tanzu cluster machinehealthcheck control-plane get CLUSTER-NAME --mhc-name MHC-NAMEオブジェクトがデフォルト名で作成された場合は、
--mhc-nameフラグを省略できます。 -
ターゲット クラスタのワーカー ノードの場合は、次のコマンドを実行します。
tanzu cluster machinehealthcheck node get CLUSTER-NAME --mhc-name MHC-NAMEオブジェクトがデフォルト名で作成された場合は、
--mhc-nameフラグを省略できます。
MachineHealthCheck オブジェクトの削除
MachineHealthCheck オブジェクトを削除するには、次の手順を実行します。
-
ターゲット クラスタの制御プレーンの場合は、次のコマンドを実行します。
tanzu cluster machinehealthcheck control-plane delete CLUSTER-NAME --mhc-name MHC-NAMEオブジェクトがデフォルト名で作成された場合は、
--mhc-nameフラグを省略できます。 -
ターゲット クラスタのワーカー ノードの場合は、次のコマンドを実行します。
tanzu cluster machinehealthcheck node delete CLUSTER-NAME --mhc-name MHC-NAMEオブジェクトがデフォルト名で作成された場合は、
--mhc-nameフラグを省略できます。
