웹 서버가 필요한 보조 프로그램은 두 서비스가 올바른 순서로 시작되어도 첫 요청을 너무 일찍 보낼 수 있습니다. 상태 검사는 Docker가 실행하는 짧은 테스트입니다. 예를 들어 서비스가 HTTP 요청에 응답할 수 있는지 확인합니다.
Docker Compose · 레슨 6
서비스 의존 관계
의존하는 서비스를 먼저 시작하는 것과 그 서비스가 요청에 응답할 준비가 되는 것의 차이를 알아봅니다.
준비 상태 검사 고르기
이 별도 예제에서는 웹 컨테이너 안에서 검사를 실행합니다. 컨테이너 내부에서 웹 페이지를 요청합니다. 요청이 성공하면 그 위치에서 서버가 응답한다는 사실을 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의 시작 조건은 서비스가 처음 시작될 때의 순서를 정합니다. 처음에 정상 상태였던 서비스도 나중에 응답을 멈출 수 있습니다. 클라이언트는 요청 실패를 처리하고, 의존 대상이 다시 준비되면 연결을 재시도할 수 있어야 합니다. 현재 서비스 상태를 살펴보고 직접 요청을 보내 동작을 확인하세요.
두 서비스가 시작된 지 한 시간 뒤에 요청이 실패했습니다. 지금 무엇을 확인하면 도움이 되나요?
두 위치에서 확인하기
내부 상태 검사가 성공하면 웹 컨테이너에서 무엇에 접근할 수 있는지 알 수 있습니다. 도구 컨테이너가 접속하려면 프로젝트 네트워크와 접속 가능한 서비스 주소가 여전히 필요합니다. 상태 검사 결과와 도구 컨테이너에서 보낸 요청 결과는 따로 확인하세요.
웹 서비스는 정상으로 표시되지만 도구 컨테이너의 요청은 실패합니다. 어떤 비교를 하면 문제가 발생한 위치를 좁힐 수 있나요?
레슨 완료
서비스 의존 관계 완료
이제 상태 검사로 의존 대상이 요청에 응답할 준비가 됐는지 판단할 수 있습니다.
상태 검사가 실제로 무엇을 확인하는지 파악합니다.
시작 순서로 부족하다면 의존 대상의 정상 상태를 기다리는 조건을 선택합니다.
서비스에서 나중에 장애가 발생하면 현재 동작을 확인합니다.