Red Hat Summit1.6. マシン設定ノードのステータスの確認について
たとえば、マシン設定または kubelet 設定を使用して、クラスター内のデフォルトのコントロールプレーンノードまたはワーカーノードに変更を加える場合、マシン設定ノードカスタムリソースを使用して、ノード更新の進捗に関する詳細情報を取得できます。新しいマシン設定が生成されるような変更は、ノード更新プロセスをトリガーします。
OpenShift Container Platform のインストール時に作成された control plane および worker マシン設定プール内のノードの詳細情報を表示できます。カスタムマシン設定プールは使用できません。
MachineConfigNode カスタムリソースを使用すると、アップグレードフェーズを通過する際に、個別のノード更新の進捗をモニターできます。この情報は、更新中にノードの 1 つに問題が発生した場合のトラブルシューティングに役立ちます。カスタムリソースは、現在ノードが更新プロセスのどの段階にあるか、完了したフェーズ、および残りのフェーズを報告します。
マシン設定ノードのカスタムリソースは、テクノロジープレビュー機能のみです。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
ノードの更新プロセスは、次のフェーズとサブフェーズで構成されます。これらのフェーズは、このセクションで後述するマシン設定ノードのカスタムリソースによって追跡されます。
Update Prepared: MCO は設定ドリフトモニタリングプロセスを停止し、新たに作成されたマシン設定がノードに適用できることを確認します。
- UpdateCompatible
Update Executed: MCO はノードをスケジューリング対象から外してドレインし、必要に応じて新しいマシン設定をノードのファイルおよびオペレーティングシステムに適用します。次のサブフェーズが含まれています。
- Cordoned
- Drained
- AppliedFilesAndOS
- PinnedImageSetsProgressing: MCO は、コンテナーイメージの固定および事前ロードに必要な手順を実行しています。
-
PinnedImageSetsDegraded: 固定されたイメージプロセスに失敗しました。
oc describe machineconfignodeコマンドを使用すると、このセクションの後半で説明するように、障害の理由を表示できます。 Update Post update action: MCO は、必要に応じてノードを再起動するか CRI-O を再ロードします。
- RebootedNode
- ReloadedCRIO
Update Complete: MCO はノードをスケジューリング対象に戻し、ノードの状態をクラスターに更新して、ノードのメトリクスの生成を再開します。
- Updated
- Uncordoned
- Resumed: MCO は設定ドリフトモニタープロセスを再起動し、ノードは運用状態に戻ります。
更新がこれらのフェーズを通過すると、MachineConfigNode カスタムリソースをクエリーできます。これは、フェーズごとに次のいずれかの条件を報告します。
-
True: そのノードでフェーズが完了したか、MCO がそのノードでそのフェーズを開始したことを意味します。 -
False: そのノードでは、フェーズが実行中であるか、実行されないことを意味します。 -
Unknown: そのノードでは、フェーズが実行中であるか、エラーが発生していることを意味します。フェーズにエラーがある場合、このセクションで後で説明するように、oc describe machineconfignodesコマンドを使用して詳細情報を取得できます。
たとえば、新たに作成されたマシン設定を持つクラスターを考えてみます。
oc get machineconfig
$ oc get machineconfig出力例
新しいマシン設定でノードが更新される様子を監視できます。
oc get machineconfignodes
$ oc get machineconfignodes出力例
| フィールド | 意味 |
|---|---|
|
| ノードの名前。 |
|
| そのノードに関連付けられたマシン設定プールの名前。 |
|
| ノードの更新先である新しいマシン設定の名前。 |
|
| そのノード上の現在のマシン設定の名前。 |
|
| ノードが次のいずれかの条件で更新されたかどうかを示します。
|
-o wide フラグを使用すると、更新に関する追加情報を表示できます。
oc get machineconfignodes -o wide
$ oc get machineconfignodes -o wide出力例
前の表で定義されたフィールドに加え、-o wide 出力には以下のフィールドが表示されます。
| フェーズ名 | 定義 |
|---|---|
|
| MCO がノードを更新する準備ができているかどうかを示します。 |
|
| MCO がノードで更新の本体を完了したかどうかを示します。 |
|
| MCO がノードで更新後のアクションを実行したかどうかを示します。 |
|
| MCO がノードで更新を完了したかどうかを示します。 |
|
| ノードが通常のプロセスを再開したかどうかを示します。 |
|
| MCO がノードで更新を実行できると判断したかどうかを示します。 |
|
| MCO がノードファイルとオペレーティングシステムを更新したかどうかを示します。 |
|
| MCO がノードをスケジュール対象外としてマークしているかどうかを示します。 |
|
| MCO がノードをドレインしたかどうかを示します。 |
|
| MCO がノードを再起動したかどうかを示します。 |
|
| MCO が CRI-O サービスを再起動したかどうかを示します。 |
|
| MCO がノードをスケジュール対象としてマークしているかどうかを示します。 |
更新ステータスの詳細は、oc describe machineconfignode コマンドを使用できます。
oc describe machineconfignode/<machine_config_node_name>
$ oc describe machineconfignode/<machine_config_node_name>出力例
1.6.1. マシン設定ノードのステータスの確認
マシン設定プール (MCP) の更新中、oc get machineconfignodes コマンドおよび oc describe machineconfignodes コマンドを使用して、クラスター内のすべてのコントロールプレーンおよびワーカーノードの進捗をモニターできます。これらのコマンドは、更新時に問題が発生し、ノードのトラブルシューティングが必要な場合に役立つ情報を提供します。
これらのコマンドは、カスタムのマシン設定プールでは使用できません。
これらのフィールドの意味に関する詳細は、「マシン設定ノードのステータスの確認について」を参照してください。
前提条件
clusterという名前のFeatureGateCR を編集して、クラスターに必要なテクノロジープレビュー機能を有効にした。oc edit featuregate cluster
$ oc edit featuregate clusterCopy to Clipboard Copied! Toggle word wrap Toggle overflow FeatureGateCR の例Copy to Clipboard Copied! Toggle word wrap Toggle overflow 警告クラスターで
TechPreviewNoUpgrade機能セットを有効にすると、元に戻すことができず、マイナーバージョンの更新が妨げられます。この機能セットを使用すると、該当するテクノロジープレビュー機能をテストクラスターで有効にして、完全にテストすることができます。実稼働クラスターではこの機能セットを有効にしないでください。変更を保存すると、新規マシン設定が作成され、マシン設定プールが更新され、変更が適用されている間に各ノードのスケジューリングが無効になります。
手順
次のコマンドを実行して、現在のマシン設定と必要なマシン設定を含む、クラスター内のすべてのノードの更新ステータスを表示します。
oc get machineconfignodes
$ oc get machineconfignodesCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、クラスター内のノードのすべてのマシン設定ノードステータスフィールドを表示します。
oc get machineconfignodes -o wide
$ oc get machineconfignodes -o wideCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、特定のマシン設定プールに含まれるノードの更新ステータスを確認します。
oc get machineconfignodes $(oc get machineconfignodes -o json | jq -r '.items[]|select(.spec.pool.name=="<pool_name>")|.metadata.name')
$ oc get machineconfignodes $(oc get machineconfignodes -o json | jq -r '.items[]|select(.spec.pool.name=="<pool_name>")|.metadata.name')1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME POOLNAME DESIREDCONFIG CURRENTCONFIG UPDATED ci-ln-g6dr34b-72292-g9btv-worker-a-sjh5r worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-d5534cb730e5e108905fc285c2a42b6c True ci-ln-g6dr34b-72292-g9btv-worker-b-xthbz worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-faf6b50218a8bbce21f1370866283de5 False ci-ln-g6dr34b-72292-g9btv-worker-c-gnpd6 worker rendered-worker-faf6b50218a8bbce21f1370866283de5 rendered-worker-faf6b50218a8bbce21f1370866283de5 True
NAME POOLNAME DESIREDCONFIG CURRENTCONFIG UPDATED ci-ln-g6dr34b-72292-g9btv-worker-a-sjh5r worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-d5534cb730e5e108905fc285c2a42b6c True ci-ln-g6dr34b-72292-g9btv-worker-b-xthbz worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-faf6b50218a8bbce21f1370866283de5 False ci-ln-g6dr34b-72292-g9btv-worker-c-gnpd6 worker rendered-worker-faf6b50218a8bbce21f1370866283de5 rendered-worker-faf6b50218a8bbce21f1370866283de5 TrueCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、個々のノードの更新ステータスを確認します。
oc describe machineconfignode/<node_name>
$ oc describe machineconfignode/<node_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}