HEALTHCHECK [옵션] CMD <명령어>

HEALTHCHECK \
  --interval=30s \    # 헬스체크 실행 주기 (기본값: 30s)
  --timeout=10s \     # 명령어 응답 대기 시간 (기본값: 30s)
  --start-period=40s \ # 시작 유예 기간 (기본값: 0s)
  --retries=3 \       # 연속 실패 허용 횟수 (기본값: 3)
  CMD curl -f http://localhost/health || exit 1

타임라인:
컨테이너 시작
    │
    ├─ [start-period 40s] ─────────────────┐
    │  이 기간 동안 실패해도 retries 카운터  │
    │  증가 없음 (starting 상태 유지)        │
    │                                      │
    └──────────────────────────────────────┘
    │
    ├─ interval=30s ──┐ interval=30s ──┐ interval=30s
    │                 │                │
   [check1: 성공]   [check2: 실패]   [check3: 실패]
    │                 │                │
  healthy           retries=1        retries=2
                                       │
                              [check4: 실패] → retries=3 → unhealthy!

FROM nginx:alpine

# nginx에 curl 설치
RUN apk add --no-cache curl

HEALTHCHECK \
  --interval=15s \
  --timeout=5s \
  --start-period=10s \
  --retries=3 \
  CMD curl -f http://localhost/ || exit 1

COPY nginx.conf /etc/nginx/nginx.conf

FROM node:18-alpine

WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .

EXPOSE 3000

HEALTHCHECK \
  --interval=20s \
  --timeout=5s \
  --start-period=30s \
  --retries=3 \
  CMD node -e "require('http').get('http://localhost:3000/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1)).on('error', () => process.exit(1))"

CMD ["node", "server.js"]

HEALTHCHECK NONE

restart: "no"

# 실습 디렉토리 준비
mkdir -p /tmp/docker/part5/exam_19 && cd /tmp/docker/part5/exam_19

$ docker run --rm alpine echo "작업 완료"
작업 완료
# 종료 후 자동 삭제, 재시작 없음

restart: always

$ docker run -d --restart=always --name demo nginx:alpine
$ docker stop demo
$ sudo systemctl restart docker
$ docker ps   # demo 컨테이너가 다시 실행 중!

restart: on-failure:3

# 의도적으로 실패하는 컨테이너 테스트
$ docker run -d --restart=on-failure:3 --name crasher \
    alpine sh -c "echo '크래시!' && exit 1"

$ docker ps -a
# CONTAINER ID   STATUS
# abc123         Restarting (1) 5 seconds ago
# → 3회 실패 후 더 이상 재시작 안 함

$ docker inspect crasher --format '{{.RestartCount}}'
3

restart: unless-stopped

재시작 정책 비교표:

상황                          | no  | always | on-failure | unless-stopped
-----------------------------|-----|--------|------------|---------------
정상 종료 (exit 0)            |  -  |  재시작 |     -      |    재시작
비정상 종료 (exit != 0)       |  -  |  재시작 |   재시작    |    재시작
docker stop 후 데몬 재시작    |  -  |  재시작 |   재시작    |      -
크래시 무한 루프 방지          |  O  |   X    | O (횟수제한)|      X

# 개발/테스트: 재시작 없이 로그 확인
restart: "no"

# 웹서버, API 서버 등 항상 켜져야 하는 서비스
restart: unless-stopped

# 시스템 필수 서비스 (모니터링 에이전트 등)
restart: always

# 빠른 크래시-재시작 루프를 방지해야 하는 서비스
restart: on-failure:5

컨테이너 시작
     ↓
 starting       ← --start-period 동안 (헬스체크 실패해도 unhealthy로 안 감)
     ↓
 healthy        ← 헬스체크 성공
     또는
 unhealthy      ← --retries 횟수 연속 실패 시

# 컨테이너 상태 확인 (STATUS 컬럼)
docker ps
# NAME      STATUS
# api       Up 2 min (healthy)    ← 정상
# db        Up 30s (starting)     ← 초기화 중
# worker    Up 5 min (unhealthy)  ← 문제 발생!

HEALTHCHECK [OPTIONS] CMD <command>

# 옵션:
# --interval=DURATION   헬스체크 실행 간격 (기본: 30s)
# --timeout=DURATION    타임아웃 (기본: 30s)
# --start-period=DURATION  초기화 유예 기간 (기본: 0s)
# --retries=N           연속 실패 횟수 → unhealthy (기본: 3)

# HTTP 서버 헬스체크
HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
  CMD curl -f http://localhost:8080/health || exit 1

# TCP 포트 확인 (nc 사용)
HEALTHCHECK --interval=10s --timeout=5s --retries=3 \
  CMD nc -z localhost 5432 || exit 1

# 커스텀 스크립트
HEALTHCHECK --interval=30s CMD /app/healthcheck.sh

# 헬스체크 비활성화 (상위 이미지의 HEALTHCHECK 제거)
HEALTHCHECK NONE

services:
  db:
    image: postgres:16-alpine
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "postgres"]
      interval: 5s
      timeout: 5s
      retries: 5
      start_period: 10s

  redis:
    image: redis:7-alpine
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 3

  app:
    image: myapp
    depends_on:
      db:
        condition: service_healthy     # DB가 healthy 될 때까지 대기
      redis:
        condition: service_healthy     # Redis도 healthy 될 때까지 대기
    # depends_on 없이 그냥 실행하면:
    # DB 컨테이너가 시작됐어도 PostgreSQL이 아직 초기화 중
    # → 앱이 DB 연결 실패로 크래시 → restart → 연결 성공
    # (retry 루프로 해결 가능하지만, service_healthy가 더 깔끔)

# 최근 헬스체크 결과 확인
docker inspect my-container --format \
  '{{range .State.Health.Log}}{{.Start}} Exit:{{.ExitCode}} {{.Output}}{{end}}'

# Python으로 보기 좋게 출력
docker inspect my-container | python3 -c "
import sys, json
data = json.load(sys.stdin)
health = data[0]['State']['Health']
print('Status:', health['Status'])
print('--- Last 3 checks ---')
for h in health['Log'][-3:]:
    print(h['Start'][:19], 'ExitCode:', h['ExitCode'])
    if h['Output']:
        print(' ', h['Output'][:100])
"

# no (기본값): 재시작 안 함
docker run --restart no myapp

# always: 항상 재시작 (수동 docker stop 후 Docker 재시작해도 시작됨)
docker run --restart always myapp

# unless-stopped: 수동으로 stop한 경우만 제외하고 재시작 (권장)
docker run --restart unless-stopped myapp

# on-failure: 오류 종료(exit code ≠ 0)일 때만 재시작
docker run --restart on-failure myapp

# on-failure:N: 최대 N번 시도 후 포기
docker run --restart on-failure:3 myapp

시나리오: 유지보수를 위해 docker stop myapp 실행 후
          서버를 재부팅했을 때 어떻게 되는가?

always:          재부팅 후 컨테이너 자동 시작됨 ← 의도치 않은 재시작!
unless-stopped:  재부팅 후도 중지 상태 유지됨 ✓ (stop한 의도를 기억)

# 예시
docker run -d --name myapp --restart always myapp
docker stop myapp          # 유지보수를 위해 중지
sudo reboot                # 서버 재부팅
# 재부팅 후: myapp 컨테이너가 자동 시작됨 (always)

docker run -d --name myapp --restart unless-stopped myapp
docker stop myapp          # 유지보수를 위해 중지
sudo reboot                # 서버 재부팅
# 재부팅 후: myapp 컨테이너 중지 상태 유지 (unless-stopped) ✓

# 재시작 횟수 확인
docker inspect myapp --format '{{.RestartCount}}'
# 5 → 5번 재시작됨

# 현재 재시작 정책 확인
docker inspect myapp --format '{{.HostConfig.RestartPolicy}}'
# {unless-stopped 0}

# 실행 중인 컨테이너 재시작 정책 변경 (재시작 필요 없음)
docker update --restart unless-stopped myapp