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

手順

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