Um programa auxiliar que depende de um servidor web pode enviar a primeira requisição cedo demais, mesmo se os dois iniciarem na ordem certa. Uma verificação de saúde é um teste curto executado pelo Docker para ver se o serviço consegue cumprir uma função, como responder a uma requisição HTTP.
Docker Compose · Lição 6
Dependências entre serviços
Aprenda a distinguir a ordem de inicialização das dependências da capacidade de responder a requisições.
Como verificar se o serviço está pronto
Neste exemplo separado, a verificação roda dentro do contêiner web. Ela solicita a página local. Se a requisição passar, o Docker sabe que o servidor responde a partir daquele ponto.
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
Salve o exemplo como compose.health.yaml na mesma pasta de prática. A verificação se repete em intervalos e cada tentativa tem um limite de tempo. Ela testa uma resposta local dentro do contêiner web.
Onde wget é executado nessa verificação de saúde?
Como aguardar uma dependência saudável
Com a condição service_healthy, o Compose aguarda uma verificação bem-sucedida antes de iniciar o contêiner de ferramentas que depende do servidor. Quando só a ordem de inicialização é definida, o serviço dependente pode iniciar assim que o servidor estiver rodando, mesmo antes que ele consiga responder a uma requisição.
$ docker compose -p journey-health -f compose.health.yaml up -d
$ docker compose -p journey-health -f compose.health.yaml ps
Procure um estado saudável na linha de web e confira se o contêiner de ferramentas está em execução.
O processo web iniciou, mas a requisição local ainda falha. Que condição deve fazer o contêiner de ferramentas esperar?

Como lidar com uma falha posterior
Uma condição de inicialização do Compose determina quando um serviço dependente vai começar a rodar. Um serviço que estava saudável pode deixar de responder depois. O cliente deve lidar com a falha da requisição e se reconectar quando a dependência voltar a ficar disponível. Consulte o estado do serviço e faça uma requisição direta para ver como ele se comporta agora.
Uma requisição falha uma hora depois de iniciar os dois serviços. Que informação ajuda agora?
Como verificar de dois pontos diferentes
Uma verificação local bem-sucedida mostra o que o contêiner web alcança de dentro dele próprio. O contêiner de ferramentas ainda precisa da rede do projeto e de um endereço pelo qual possa acessar o serviço. Confira separadamente o resultado da verificação de saúde e a resposta à requisição feita do contêiner de ferramentas.
A verificação aparece em verde, mas uma requisição do contêiner de ferramentas falha. Qual comparação ajuda a localizar o problema?
Lição concluída
Você concluiu Dependências entre serviços
Agora você consegue usar uma verificação para avaliar se uma dependência está pronta.
Identifique o que uma verificação de saúde realmente observa.
Aguarde uma dependência saudável se a ordem de inicialização não for suficiente.
Confira o comportamento atual se um serviço falhar depois de iniciar.
Salve seu progresso
Crie uma conta gratuita para salvar esta lição e continuar em qualquer dispositivo.
Criar uma conta gratuita