서비스 의존 관계
100%

Docker Compose · 레슨 6

서비스 의존 관계

의존하는 서비스를 먼저 시작하는 것과 그 서비스가 요청에 응답할 준비가 되는 것의 차이를 알아봅니다.

웹 서버가 필요한 보조 프로그램은 두 서비스가 올바른 순서로 시작되어도 첫 요청을 너무 일찍 보낼 수 있습니다. 상태 검사는 Docker가 실행하는 짧은 테스트입니다. 예를 들어 서비스가 HTTP 요청에 응답할 수 있는지 확인합니다.

준비 상태 검사 고르기

이 별도 예제에서는 웹 컨테이너 안에서 검사를 실행합니다. 컨테이너 내부에서 웹 페이지를 요청합니다. 요청이 성공하면 그 위치에서 서버가 응답한다는 사실을 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로 저장합니다. 상태 검사는 일정 간격으로 실행되고 시도마다 제한 시간이 있습니다. 웹 컨테이너 내부에서 응답을 확인하는 검사입니다.

이 상태 검사에서 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의 상태가 정상이고 도구 컨테이너가 실행 중인지 확인하세요.

웹 프로세스가 시작됐지만 컨테이너 내부 요청은 아직 실패합니다. 도구 컨테이너를 기다리게 하려면 어떤 조건을 써야 하나요?

의존 대상인 웹 서비스는 정상이고, 도구 컨테이너는 실행 중인 Compose 상태 출력

나중에 발생한 장애에 대응하기

Compose의 시작 조건은 서비스가 처음 시작될 때의 순서를 정합니다. 처음에 정상 상태였던 서비스도 나중에 응답을 멈출 수 있습니다. 클라이언트는 요청 실패를 처리하고, 의존 대상이 다시 준비되면 연결을 재시도할 수 있어야 합니다. 현재 서비스 상태를 살펴보고 직접 요청을 보내 동작을 확인하세요.

두 서비스가 시작된 지 한 시간 뒤에 요청이 실패했습니다. 지금 무엇을 확인하면 도움이 되나요?

두 위치에서 확인하기

내부 상태 검사가 성공하면 웹 컨테이너에서 무엇에 접근할 수 있는지 알 수 있습니다. 도구 컨테이너가 접속하려면 프로젝트 네트워크와 접속 가능한 서비스 주소가 여전히 필요합니다. 상태 검사 결과와 도구 컨테이너에서 보낸 요청 결과는 따로 확인하세요.

웹 서비스는 정상으로 표시되지만 도구 컨테이너의 요청은 실패합니다. 어떤 비교를 하면 문제가 발생한 위치를 좁힐 수 있나요?

레슨 완료

서비스 의존 관계 완료

이제 상태 검사로 의존 대상이 요청에 응답할 준비가 됐는지 판단할 수 있습니다.

  • 상태 검사가 실제로 무엇을 확인하는지 파악합니다.

  • 시작 순서로 부족하다면 의존 대상의 정상 상태를 기다리는 조건을 선택합니다.

  • 서비스에서 나중에 장애가 발생하면 현재 동작을 확인합니다.

학습 진행 상황 저장

무료 계정을 만들어 이 레슨을 저장하고 어떤 기기에서든 계속 학습하세요.

무료 계정 만들기
Docker Compose(으)로 돌아가기