14.7. 仮想マシンの正常性のモニタリング

手順

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

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

   # ...
   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

   VMI への接続に使用する HTTP GET 要求。

   2

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

   3

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

   4

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

   5

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

   6

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

   7

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

   8

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

2. 以下のコマンドを実行して VMI を作成します。

   $ oc create -f <file_name>.yaml

手順

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

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

   ...
   spec:
     readinessProbe:
       initialDelaySeconds: 120 1
       periodSeconds: 20 2
       tcpSocket: 3
         port: 1500 4
       timeoutSeconds: 10 5
   ...

   1

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

   2

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

   3

   実行する TCP アクション。

   4

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

   5

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

2. 以下のコマンドを実行して VMI を作成します。

   $ oc create -f <file_name>.yaml

手順

1. HTTP liveness プローブの詳細を VMI 設定ファイルに追加します。

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

   # ...
   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

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

   2

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

   3

   VMI への接続に使用する HTTP GET 要求。

   4

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

   5

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

   6

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

2. 以下のコマンドを実行して VMI を作成します。

   $ oc create -f <file_name>.yaml

手順

1. ゲストエージェント ping プローブの詳細を VMI 設定ファイルに含めます。以下に例を示します。

   ゲストエージェント ping プローブの例

   # ...
   spec:
     readinessProbe:
       guestAgentPing: {} 1
       initialDelaySeconds: 120 2
       periodSeconds: 20 3
       timeoutSeconds: 10 4
       failureThreshold: 3 5
       successThreshold: 3 6
   # ...

   1

   VMI に接続するためのゲストエージェント ping プローブ。

   2

   オプション: VMI が開始してからゲストエージェントプローブが開始されるまでの時間 (秒単位)。

   3

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

   4

   オプション: プローブがタイムアウトし、VMI が失敗したと想定されてから非アクティブになるまでの時間 (秒数)。デフォルト値は 1 です。この値は periodSeconds 未満である必要があります。

   5

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

   6

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

2. 以下のコマンドを実行して VMI を作成します。

   $ oc create -f <file_name>.yaml