Dependências entre serviços
100%

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.

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.

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?

Saída de status do Compose com o serviço web saudável e o contêiner de ferramentas em execução

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
Voltar para Docker Compose