Docker health check는 어떻게 작동하며 왜 중요합니까?

Question

Accepted Answer

**health check**는 Docker(또는 오케스트레이터)에게 container의 애플리케이션이 단지 실행 중인 것이 아니라 실제로 **작동하는지** 판단하는 방법을 알려줍니다. container의 프로세스는 살아 있으면서도 앱이 깨져 있을 수 있습니다(멈춤, 데이터베이스에 도달 불가) — health check는 이를 감지하여 플랫폼이 반응할 수 있게 합니다.

## health check 정의

```dockerfile
# Dockerfile에서
HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
  CMD curl -f http://localhost:3000/health || exit 1
# → Docker가 이 명령을 주기적으로 실행; exit 0 = 정상, 0이 아님 = 비정상
```

```yaml
# docker-compose.yml에서
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
  interval: 30s
  timeout: 3s
  retries: 3
  start_period: 10s    # 실패가 카운트되기 전 시작 시 유예 기간
```

Docker는 health check 명령을 주기적으로 실행합니다; container의 상태는 결과에 따라 `healthy` 또는 `unhealthy`가 됩니다(`docker ps`에서 보임).

## 실행 중 대 정상(핵심 구분)

```text
실행 중(RUNNING) → container의 프로세스가 살아 있음(그러나 앱이 멈췄거나 깨졌을 수 있음)
정상(HEALTHY) → health check가 앱이 실제로 작동함을 확인(올바르게 응답)
→ container가 실행 중이지만 정상이 아닐 수 있음(예: 앱이 교착 상태, DB를 잃음).
  health check 없이는 플랫폼이 "실행 중"만 알고 — 깨진 container로 계속 트래픽을 보냄.
```

## health check가 운영적으로 중요한 이유

```text
✓ 오케스트레이터가 사용함: 비정상 container 재시작; 정상인 것에만 트래픽 라우팅
✓ Compose depends_on: condition: service_healthy → 실제 준비를 기다림
✓ LIVENESS(살아 있는가? 아니면 재시작) 대 READINESS(트래픽 준비? 아니면 트래픽 보류)
  → Kubernetes는 liveness + readiness probe를 사용(같은 개념, 더 세분화됨)
✓ 깨졌지만 실행 중인 container로부터 요청을 처리하는 것을 방지
```

## 왜 중요한가

Docker health check를 이해하는 것은 **신뢰할 수 있는 컨테이너화 애플리케이션을 실행**하는 데 중요하므로, 가치 있는 운영 지식입니다.

중요한 통찰은 **실행 중과 정상**의 구분입니다. container의 프로세스는 **애플리케이션이 실제로 깨져 있는 동안에도 살아 있을** 수 있습니다(멈춤, 교착 상태, 데이터베이스에 도달 불가) — 그리고 health check 없이는 플랫폼이 container가 "실행 중"이라는 것만 알고 **깨진 container로 트래픽을 계속 라우팅하여** 실패를 야기합니다.

health check는 애플리케이션이 **실제로 작동하는지** 확인하는 방법(예: `/health` 엔드포인트에 접속)을 정의하여 이를 해결하므로, container의 상태가 단지 프로세스 생존이 아니라 실제 상태를 반영합니다.

이것은 오케스트레이터와 도구가 그것에 따라 행동하므로 **운영적으로** 중요합니다. 그것들은 **비정상 container를 재시작**하고(멈춤/교착 상태로부터 자동 복구) **정상인 것에만 트래픽을 라우팅**하며(깨진 인스턴스로 요청을 보내는 것을 피함), Compose의 `depends_on: condition: service_healthy`는 health check를 사용하여 진정한 준비를 기다립니다(시작 경쟁 상태를 해결).

관련된 **liveness 대 readiness** 구분(살아 있고 재시작되어야 하는가, 대 트래픽을 받을 준비가 되었는가)을 이해하는 것은 중요합니다. **Kubernetes가 이 같은 개념 위에 구축된 liveness와 readiness probe를 사용**하기 때문입니다 — 그래서 Docker health check를 이해하는 것이 오케스트레이션된 환경으로 직접 전이됩니다.

신뢰할 수 있는 운영은 "실행 중"과 "실제로 작동함"을 구별하고 깨졌지만 실행 중인 container에 반응하는 것(재시작, 트래픽 보류)을 요구하고, health check가 이를 가능하게 하는 메커니즘이므로 — 오케스트레이터가 자가 치유와 트래픽 라우팅에 사용함 — Docker health check를 이해하는 것은 container를 신뢰성 있게 실행하는 데 가치 있고 실질적으로 중요한 지식이며, 깨진 container가 조용히 트래픽을 계속 받는 흔한 문제를 방지하는 프로덕션 복원력의 핵심 관행이자, 오케스트레이터가 애플리케이션 상태를 유지하는 방식의 기초가 되는 개념입니다.