Web サーバーを使う補助プログラムは、正しい順番で起動しても、最初のリクエストを送るのが早すぎる場合があります。ヘルスチェックは、Docker が実行する小さなテストです。例えば、サービスが HTTP リクエストに応答できるかを調べます。
Docker Compose · レッスン 6
サービスの依存関係
依存先を先に起動することと、依存先がリクエストに応答できることの違いを学びます。
応答の準備ができたか確かめる
この例では、Web コンテナの中からヘルスチェックを実行します。コンテナ内の Web ページをリクエストし、成功すれば、その場所からサーバーが応答することを Docker が確認できます。
services:
web:
image: nginx:alpine
healthcheck:
test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"]
interval: 3s
timeout: 2s
retries: 5
toolbox:
image: busybox:1.36
command: ["sleep", "3600"]
depends_on:
web:
condition: service_healthy
同じ練習用フォルダーに compose.health.yaml として保存します。一定間隔でチェックが実行され、試行ごとに制限時間があります。ここで確認するのは、Web コンテナ内での応答です。
このヘルスチェックでは、wget はどこで実行されますか?
依存先が正常になるまで待つ
service_healthy を指定すると、Compose はヘルスチェックが成功してから、そのサービスに依存するツール用コンテナを起動します。起動順序だけを指定した場合、依存先が実行中になった時点で次のコンテナが起動できます。その時点では、依存先はまだリクエストに応答できないかもしれません。
$ docker compose -p journey-health -f compose.health.yaml up -d
$ docker compose -p journey-health -f compose.health.yaml ps
一覧の web の行が正常を示し、ツール用コンテナが実行中であることを確認します。
Web のプロセスは起動しましたが、コンテナ内からのリクエストはまだ失敗します。ツール用コンテナの起動を待たせるには、どの条件を使いますか?

起動後の障害に対処する
Compose の起動条件が決めるのは、起動時にサービスを開始する順序です。起動時に正常だったサービスも、後から応答しなくなることがあります。クライアントはリクエスト失敗に対処し、依存先が使えるようになったら再接続できるようにします。現在の状態と直接のリクエストで、今の動作を確認します。
二つのサービスが起動して一時間後に、リクエストが失敗しました。何を調べると役立ちますか?
二つの場所から確認する
コンテナ内のヘルスチェックが成功しても、分かるのは Web コンテナの内部から何にアクセスできるかです。ツール用コンテナからアクセスするには、プロジェクトのネットワークと、接続に使えるサービスのアドレスが必要です。ヘルスチェックの結果と、ツール用コンテナからのリクエストは別々に確認します。
ヘルスチェックは正常ですが、ツール用コンテナからのリクエストが失敗します。どの比較が原因の切り分けに役立ちますか?
レッスン完了
サービスの依存関係 を完了しました
チェックを使って、依存先が応答できる状態かどうかを判断できるようになりました。
ヘルスチェックで実際に何を調べているかを確認します。
起動順序だけでは足りない場合は、依存先の正常性を待つ条件を選びます。
起動後にサービスで障害が起きたら、現在の動作を確認します。