12.5. 仮想マシンのヘルスチェック

手順

1. VM 設定ファイルに readiness プローブの詳細を含めます。

   HTTP GET テストを使用した readiness プローブの例

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     annotations:
     name: fedora-vm
     namespace: example-namespace
   # ...
   spec:
     template:
       spec:
         readinessProbe:
           httpGet: 1
             port: 1500 2
             path: /healthz 3
             httpHeaders:
             - name: Custom-Header
               value: Awesome
           initialDelaySeconds: 120 4
           periodSeconds: 20 5
           timeoutSeconds: 10 6
           failureThreshold: 3 7
           successThreshold: 3 8
   # ...

   1

   VM に接続するために実行する HTTP GET 要求。

   2

   プローブがクエリーする VM のポート。上記の例では、プローブはポート 1500 をクエリーします。

   3

   HTTP サーバーでアクセスするパス。上記の例では、サーバーの /healthz パスのハンドラーが成功コードを返した場合、VM は正常であると見なされます。ハンドラーが失敗コードを返した場合、VM は使用可能なエンドポイントのリストから削除されます。

   4

   VM が起動してから準備プローブが開始されるまでの時間 (秒単位)。

   5

   プローブの実行間の遅延 (秒単位)。デフォルトの遅延は 10 秒です。この値は timeoutSeconds よりも大きくなければなりません。

   6

   プローブがタイムアウトになり、VM が失敗したと見なされるまでの非アクティブな秒数。デフォルト値は 1 です。この値は periodSeconds 未満である必要があります。

   7

   プローブが失敗できる回数。デフォルトは 3 です。指定された試行回数になると、Pod には Unready というマークが付けられます。

   8

   成功とみなされるまでにプローブが失敗後に成功を報告する必要のある回数。デフォルトでは 1 回です。

2. 次のコマンドを実行して VM を作成します。

   $ oc create -f <file_name>.yaml

手順

1. TCP readiness プローブの詳細を VM 設定ファイルに追加します。

   TCP ソケットテストを含む readiness プローブの例

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     annotations:
     name: fedora-vm
     namespace: example-namespace
   # ...
   spec:
     template:
       spec:
         readinessProbe:
           initialDelaySeconds: 120 1
           periodSeconds: 20 2
           tcpSocket: 3
             port: 1500 4
           timeoutSeconds: 10 5
   # ...

   1

   VM が起動してから準備プローブが開始されるまでの時間 (秒単位)。

   2

   プローブの実行間の遅延 (秒単位)。デフォルトの遅延は 10 秒です。この値は timeoutSeconds よりも大きくなければなりません。

   3

   実行する TCP アクション。

   4

   プローブがクエリーする VM のポート。

   5

   プローブがタイムアウトになり、VM が失敗したと見なされるまでの非アクティブな秒数。デフォルト値は 1 です。この値は periodSeconds 未満である必要があります。

2. 次のコマンドを実行して VM を作成します。

   $ oc create -f <file_name>.yaml

手順

1. VM 設定ファイルに HTTP liveness プローブの詳細を含めます。

   HTTP GET テストを使用した liveness プローブの例

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     annotations:
     name: fedora-vm
     namespace: example-namespace
   # ...
   spec:
     template:
       spec:
         livenessProbe:
           initialDelaySeconds: 120 1
           periodSeconds: 20 2
           httpGet: 3
             port: 1500 4
             path: /healthz 5
             httpHeaders:
             - name: Custom-Header
               value: Awesome
           timeoutSeconds: 10 6
   # ...

   1

   VM が起動してから liveness プローブが開始されるまでの時間 (秒単位)。

   2

   プローブの実行間の遅延 (秒単位)。デフォルトの遅延は 10 秒です。この値は timeoutSeconds よりも大きくなければなりません。

   3

   VM に接続するために実行する HTTP GET 要求。

   4

   プローブがクエリーする VM のポート。上記の例では、プローブはポート 1500 をクエリーします。VM は、cloud-init を介してポート 1500 に最小限の HTTP サーバーをインストールして実行します。

   5

   HTTP サーバーでアクセスするパス。上記の例では、サーバーの /healthz パスのハンドラーが成功コードを返した場合、VM は正常であると見なされます。ハンドラーが失敗コードを返した場合、VM は削除され、新しい VM が作成されます。

   6

   プローブがタイムアウトになり、VM が失敗したと見なされるまでの非アクティブな秒数。デフォルト値は 1 です。この値は periodSeconds 未満である必要があります。

2. 次のコマンドを実行して VM を作成します。

   $ oc create -f <file_name>.yaml

手順

1. 次の内容で YAML ファイルを作成します。

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     labels:
       kubevirt.io/vm: vm2-rhel84-watchdog
     name: <vm-name>
   spec:
     running: false
     template:
       metadata:
         labels:
           kubevirt.io/vm: vm2-rhel84-watchdog
       spec:
         domain:
           devices:
             watchdog:
               name: <watchdog>
               i6300esb:
                 action: "poweroff" 1
   # ...

   1

   poweroff、reset、または shutdown を指定します。

   上記の例では、電源オフアクションを使用して、RHEL8 VM で i6300esb ウォッチドッグデバイスを設定し、デバイスを /dev/watchdog として公開します。

   このデバイスは、ウォッチドッグバイナリーで使用できるようになりました。

2. 以下のコマンドを実行して、YAML ファイルをクラスターに適用します。

   $ oc apply -f <file_name>.yaml

1. 以下のコマンドを実行して、VM がウォッチドッグデバイスに接続されていることを確認します。

   $ lspci | grep watchdog -i

2. 以下のコマンドのいずれかを実行して、ウォッチドッグがアクティブであることを確認します。

   • カーネルパニックをトリガーします。

     # echo c > /proc/sysrq-trigger

   • ウォッチドッグサービスを停止します。

     # pkill -9 watchdog

手順

1. root ユーザーとして仮想マシンにログインします。

2. watchdog ドッグパッケージとその依存関係をインストールします。

   # yum install watchdog

3. /etc/watchdog.conf ファイルの次の行のコメントを外し、変更を保存します。

   #watchdog-device = /dev/watchdog

4. 起動時に watchdog サービスを開始できるようにします。

   # systemctl enable --now watchdog.service