13.3. OpenShift Virtualization でのホステッドクラスターのトラブルシューティング

手順

• OpenShift Virtualization 上のホステッドクラスターの前提条件をすべて満たしていることを確認します。
• 進行を妨げる検証エラーがないか、HostedCluster リソースと NodePool リソースの状態を表示します。

• ホステッドクラスターの kubeconfig ファイルを使用して、ホステッドクラスターのステータスを検査します。

  • oc get clusteroperators コマンドの出力を表示して、保留中のクラスター Operator を表示します。
  • oc get nodes コマンドの出力を表示して、ワーカーノードの準備ができていることを確認します。

手順

• HostedCluster と NodePool の障害の状態を表示して、問題の内容を示します。

• 次のコマンドを入力して、NodePool リソースの KubeVirt ワーカーノード仮想マシン (VM) のステータスを表示します。

  $ oc get vm -n <namespace>

• 仮想マシンがプロビジョニング状態でスタックしている場合は、次のコマンドを入力して、仮想マシン namespace 内の CDI インポート Pod を表示し、インポーター Pod が完了していない理由を調べます。

  $ oc get pods -n <namespace> | grep "import"

• 仮想マシンが開始状態でスタックしている場合は、次のコマンドを入力して、virt-launcher Pod のステータスを表示します。

  $ oc get pods -n <namespace> -l kubevirt.io=virt-launcher

  virt-launcher Pod が保留状態にある場合は、Pod がスケジュールされていない理由を調査してください。たとえば、virt-launcher Pod の実行に必要なリソースが十分存在しない可能性があります。

• 仮想マシンが実行されていてもワーカーノードとして登録されていない場合は、Web コンソールを使用して、影響を受ける仮想マシンの 1 つへの VNC アクセスを取得します。VNC 出力は ignition 設定が適用されたかどうかを示します。仮想マシンが起動時に Hosted Control Plane Ignition サーバーにアクセスできない場合、仮想マシンは正しくプロビジョニングできません。
• Ignition 設定が適用されても、仮想マシンがノードとして登録されない場合は、問題の特定: 仮想マシンコンソールログへのアクセス で、起動時に仮想マシンコンソールログにアクセスする方法を確認してください。

• 次のコマンドを入力して、ノードオブジェクトの状態を表示し、ノードの準備ができていない理由を特定します。

  $ oc get nodes -o yaml

• 次のコマンドを入力して、クラスター内で障害が発生している Pod を探します。

  $ oc get pods -A --field-selector=status.phase!=Running,status,phase!=Succeeded

手順

• クラスターがデフォルトの Ingress 動作を使用する場合は、次のコマンドを入力して、仮想マシン (VM) がホストされている OpenShift Container Platform クラスターでワイルドカード DNS ルートが有効になっていることを確認します。

  $ oc patch ingresscontroller -n openshift-ingress-operator \
    default --type=json -p \
    '[{ "op": "add", "path": "/spec/routeAdmission", "value": {wildcardPolicy: "WildcardsAllowed"}}]'

• Hosted Control Plane にカスタムベースドメインを使用する場合は、次の手順を実行します。

  • ロードバランサーが仮想マシン Pod を正しくターゲットにしていることを確認します。
  • ワイルドカード DNS エントリーがロードバランサー IP をターゲットにしていることを確認します。

手順

• ホステッドクラスター内のロードバランサーサービスに関連付けられたイベントおよび詳細を探します。

• デフォルトでは、ホステッドクラスターのロードバランサーは、Hosted Control Plane の namespace 内の kubevirt-cloud-controller-manager によって処理されます。KCCM Pod がオンラインであることを確認し、ログでエラーや警告を確認します。Hosted Control Plane の namespace で KCCM Pod を特定するには、次のコマンドを入力します。

  $ oc get pods -n <hosted_control_plane_namespace> -l app=cloud-controller-manager

手順

• PVC に関連するイベントと詳細を探して、どのエラーが発生しているかを把握します。

• PVC が Pod に割り当てられていない場合は、ホステッドクラスター内の kubevirt-csi-node daemonset コンポーネントのログを表示して、問題をさらに調査します。各ノードの kubevirt-csi-node Pod を識別するには、次のコマンドを入力します。

  $ oc get pods -n openshift-cluster-csi-drivers -o wide -l app=kubevirt-csi-driver

• PVC が永続ボリューム (PV) にバインドできない場合は、Hosted Control Plane の namespace 内の kubevirt-csi-controller コンポーネントのログを表示します。Hosted Control Plane の namespace 内の kubevirt-csi-controller Pod を識別するには、次のコマンドを入力します。

  $ oc get pods -n <hcp namespace> -l app=kubevirt-csi-driver

手順

• 仮想マシンコンソールログにアクセスするには、How to get serial console logs for VMs part of OpenShift Virtualization Hosted Control Plane clusters の手順を実行します。