Elastic Container Instance:プローブを使用したコンテナのヘルスチェック

概要

ECI は liveness プローブと readiness プローブをサポートし、コンテナのヘルス状態とステータスをチェックします。

API 設定

CreateContainerGroup 操作で ECI インスタンスを作成する際に、LivenessProbe および ReadinessProbe パラメーターを使用してプローブを設定できます。詳細については、「CreateContainerGroup」をご参照ください。

コンソールでの設定

Elastic Container Instance コンソールで ECI インスタンスを作成する際、コンテナー設定 セクションでコンテナを選択し、コンテナの詳細設定を展開してヘルスチェックを有効にし、プローブを設定できます。

例

この例では、liveness プローブと readiness プローブを使用して ECI インスタンスを作成し、サービスの障害をシミュレートしてプローブの動作を確認する方法を示します。

1. CreateContainerGroup 操作を呼び出して ECI インスタンスを作成します。

   次の例では、ヘルスチェックに TCP ソケットメソッドを使用します：

   ContainerGroupName=test-probe
   # nginx イメージを使用し、EIP を自動的に作成して関連付けます。
   Container.1.Name=container-1
   Container.1.Image=nginx
   AutoCreateEip=true
   # Liveness プローブ：起動後 5 秒で開始し、3 秒ごとにポート 80 をチェックします。成功のしきい値：1、失敗のしきい値：3、タイムアウト：10 秒。
   Container.1.LivenessProbe.TcpSocket.Port=80
   Container.1.LivenessProbe.InitialDelaySeconds=5
   Container.1.LivenessProbe.PeriodSeconds=3
   Container.1.LivenessProbe.SuccessThreshold=1
   Container.1.LivenessProbe.FailureThreshold=3
   Container.1.LivenessProbe.TimeoutSeconds=10
   # Readiness プローブ：起動後 5 秒で開始し、3 秒ごとにポート 80 をチェックします。成功のしきい値：1、失敗のしきい値：3、タイムアウト：10 秒。
   Container.1.ReadinessProbe.TcpSocket.Port=80
   Container.1.ReadinessProbe.InitialDelaySeconds=5
   Container.1.ReadinessProbe.PeriodSeconds=3
   Container.1.ReadinessProbe.SuccessThreshold=1
   Container.1.ReadinessProbe.FailureThreshold=3
   Container.1.ReadinessProbe.TimeoutSeconds=10

2. Elastic Container Instance コンソールで ECI インスタンスのイベントを表示します。

   ECI インスタンスが作成されたら、インスタンス ID をクリックして詳細ページを開きます。イベント タブで、コンテナが正常に起動したことを確認できます。

   イベントリストには、「Pulling image "nginx"」、「Successfully pulled image "nginx"」、「Created container container-1」、「Started container container-1」の 4 つの Normal イベントが順番に表示されます。

3. コンテナに接続します。詳細については、「ワークベンチを使用して ECI インスタンスに接続」をご参照ください。

4. Nginx のリッスンポートを変更して、サービスの障害をシミュレートします。

   1. Nginx のリッスンポートを変更します。

      説明

      この例で使用されている Nginx イメージには vim がインストールされていません。vi コマンドを実行する前に、apt-get update と apt-get install vim を実行して vim をインストールしてください。

      vi /etc/nginx/conf.d/default.conf

      次の例に示すように、リッスンポートを 80 から 8080 に変更します：

      server {
          listen       8080;
          listen  [::]:8080;
          server_name  localhost;
          #access_log  /var/log/nginx/host.access.log  main;
          location / {
              root   /usr/share/nginx/html;
              index  index.html index.htm;
          }
          #error_page  404              /404.html;
          # redirect server error pages to the static page /50x.html
          #
          error_page   500 502 503 504  /50x.html;
          location = /50x.html {
              root   /usr/share/nginx/html;
          }
      }

   2. Nginx の設定を再読み込みします。

      nginx -s reload

5. プローブの効果を確認します。

   Nginx を再読み込みしてから数秒後、コンテナは自動的に再起動します。インスタンスのイベントを表示して、liveness プローブと readiness プローブが失敗した後にコンテナが再起動することを確認できます。

   イベントリストには、プローブがメッセージ dial tcp 172.x.x.x:80: connect: connection refused とともに失敗したことが示されます。これは、コンテナポートへの接続が拒否されたことを意味します。その結果、ECI は自動的に container-1 コンテナを再起動しました。