サービスの依存関係
100%

Docker Compose · レッスン 6

サービスの依存関係

依存先を先に起動することと、依存先がリクエストに応答できることの違いを学びます。

Web サーバーを使う補助プログラムは、正しい順番で起動しても、最初のリクエストを送るのが早すぎる場合があります。ヘルスチェックは、Docker が実行する小さなテストです。例えば、サービスが HTTP リクエストに応答できるかを調べます。

応答の準備ができたか確かめる

この例では、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 のプロセスは起動しましたが、コンテナ内からのリクエストはまだ失敗します。ツール用コンテナの起動を待たせるには、どの条件を使いますか?

依存先の web が正常で、ツール用コンテナが実行中であることを示す Compose の状態表示

起動後の障害に対処する

Compose の起動条件が決めるのは、起動時にサービスを開始する順序です。起動時に正常だったサービスも、後から応答しなくなることがあります。クライアントはリクエスト失敗に対処し、依存先が使えるようになったら再接続できるようにします。現在の状態と直接のリクエストで、今の動作を確認します。

二つのサービスが起動して一時間後に、リクエストが失敗しました。何を調べると役立ちますか?

二つの場所から確認する

コンテナ内のヘルスチェックが成功しても、分かるのは Web コンテナの内部から何にアクセスできるかです。ツール用コンテナからアクセスするには、プロジェクトのネットワークと、接続に使えるサービスのアドレスが必要です。ヘルスチェックの結果と、ツール用コンテナからのリクエストは別々に確認します。

ヘルスチェックは正常ですが、ツール用コンテナからのリクエストが失敗します。どの比較が原因の切り分けに役立ちますか?

レッスン完了

サービスの依存関係 を完了しました

チェックを使って、依存先が応答できる状態かどうかを判断できるようになりました。

  • ヘルスチェックで実際に何を調べているかを確認します。

  • 起動順序だけでは足りない場合は、依存先の正常性を待つ条件を選びます。

  • 起動後にサービスで障害が起きたら、現在の動作を確認します。

学習進捗を保存

無料アカウントを作成してこのレッスンを保存し、どのデバイスからでも学習を続けられます。

無料アカウントを作成
Docker Compose に戻る