Kubernetes Probe 3종류, 왜 나눠져 있는가

flowchart LR
    subgraph Probes["Probe 역할"]
        Startup[StartupProbe<br/>시작 완료?]
        Readiness[ReadinessProbe<br/>트래픽 OK?]
        Liveness[LivenessProbe<br/>살아있어?]
    end

    subgraph Actions["실패 시 동작"]
        Wait[대기]
        Remove[Service에서 제외]
        Restart[Pod 재시작]
    end

    Startup -->|실패| Wait
    Readiness -->|실패| Remove
    Liveness -->|실패| Restart

    style Startup fill:#74c0fc,color:#000
    style Readiness fill:#69db7c,color:#000
    style Liveness fill:#ef4444,color:#000

StartupProbe   → 시작할 때만 (1회성)
ReadinessProbe → 트래픽 On/Off (반복)
LivenessProbe  → 죽으면 재시작 (반복)

1
2
3
4
5
6

# 예전 방식: LivenessProbe에서 시작 대기
livenessProbe:
  httpGet:
    path: /health
  initialDelaySeconds: 120  # 2분 대기
  periodSeconds: 10

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 시작할 때는 충분히 대기
startupProbe:
  httpGet:
    path: /health
  periodSeconds: 10
  failureThreshold: 18    # 최대 3분 대기

# 시작 후에는 빠르게 감지
livenessProbe:
  httpGet:
    path: /health
  periodSeconds: 10
  failureThreshold: 3

sequenceDiagram
    participant K as Kubernetes
    participant P as Pod

    K->>P: StartupProbe 시작
    loop 시작 중
        P-->>K: 실패 (아직 준비 안 됨)
    end
    P-->>K: 성공!

    Note over K,P: 이제부터 Readiness/Liveness 시작

    K->>P: ReadinessProbe
    K->>P: LivenessProbe

1
2
3
4
5
6
7

startupProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 10
  periodSeconds: 10
  failureThreshold: 30    # 최대 약 5분 10초 대기 (10초 + 10초 × 30회)

1
2
3
4
5
6

readinessProbe:
  httpGet:
    path: /ready
    port: 8080
  periodSeconds: 10
  failureThreshold: 3

1
2
3
4
5
6
7

livenessProbe:
  httpGet:
    path: /health
    port: 8080
  periodSeconds: 10
  timeoutSeconds: 5
  failureThreshold: 3

1
2
3
4
5
6

# 위험한 설정
livenessProbe:
  httpGet:
    path: /health
  timeoutSeconds: 1      # 너무 짧음!
  failureThreshold: 1    # 1번 실패로 재시작

flowchart LR
    A[부하 증가] --> B[응답 지연]
    B --> C[LivenessProbe 실패]
    C --> D[Pod 재시작]
    D --> E[다른 Pod에 부하 전가]
    E --> B

    style C fill:#dc2626,color:#fff
    style D fill:#dc2626,color:#fff

1
2
3
4
5
6

livenessProbe:
  httpGet:
    path: /health        # 단순한 체크만!
  timeoutSeconds: 5      # 여유있게
  failureThreshold: 3    # 3번 실패해야 재시작
  periodSeconds: 10

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

// LivenessProbe - 단순하게
@GetMapping("/health")
public String health() {
    return "OK";
}

// ReadinessProbe - 의존성 체크
@GetMapping("/ready")
public String ready() {
    // DB 연결 확인
    jdbcTemplate.queryForObject("SELECT 1", Integer.class);
    return "OK";
}

// StartupProbe - 초기화 완료 확인
@GetMapping("/startup")
public String startup() {
    if (!initialized) {
        throw new RuntimeException("Not ready");
    }
    return "OK";
}

sequenceDiagram
    participant K as Kubernetes
    participant P as Pod (JVM)
    participant C as 클라이언트

    Note over P: Pod 시작

    K->>P: StartupProbe
    P-->>K: 성공 (Spring Boot 기동 완료)

    Note over K,P: Readiness/Liveness 시작

    K->>P: ReadinessProbe
    P-->>K: 성공

    Note over K: Endpoint 등록, 트래픽 전달 시작

    C->>P: 첫 번째 요청
    Note over P: 클래스 로딩 + 인터프리터 실행
    P-->>C: 응답 (느림)

    C->>P: 두 번째 요청
    Note over P: JIT 컴파일 진행 중
    P-->>C: 응답 (아직 느림)

    Note over P: JIT 컴파일 완료, 캐시 적재

    C->>P: N번째 요청
    P-->>C: 응답 (정상 속도)

sequenceDiagram
    participant K as Kubernetes
    participant P as Pod (JVM)
    participant C as 클라이언트

    Note over P: Pod 시작

    K->>P: StartupProbe
    P-->>K: 실패 (Spring Boot 기동 중)

    K->>P: StartupProbe
    P-->>K: 실패 (Warm-up 진행 중)
    Note over K: Readiness/Liveness 시작 안 함<br/>트래픽 보내지 않음

    Note over P: Warm-up 완료

    K->>P: StartupProbe
    P-->>K: 성공

    Note over K,P: Readiness/Liveness 시작

    K->>P: ReadinessProbe
    P-->>K: 성공
    Note over K: Endpoint 등록

    C->>P: 요청
    P-->>C: 응답 (정상 속도)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

@Component
public class WarmupHealthIndicator implements HealthIndicator {

    private volatile boolean warmupDone = false;

    @EventListener(ApplicationReadyEvent.class)
    public void onReady() {
        // 앱 시작 후 warm-up 실행
        runWarmup();
        warmupDone = true;
    }

    @Override
    public Health health() {
        if (warmupDone) {
            return Health.up().build();
        }
        return Health.down()
            .withDetail("reason", "Warm-up in progress")
            .build();
    }

    private void runWarmup() {
        // 1. 주요 API 내부 호출 (클래스 로딩 유도)
        // 2. DB 쿼리 실행 (커넥션 풀 초기화)
        // 3. 캐시 적재
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# application.yml
management:
  endpoint:
    health:
      group:
        startup:
          include: livenessState, warmup    # warm-up 포함
        readiness:
          include: readinessState           # warm-up 제외 (이미 통과했으므로)
        liveness:
          include: livenessState            # warm-up 제외

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# Kubernetes Probe 설정
startupProbe:
  httpGet:
    path: /actuator/health/startup    # warm-up 포함
  periodSeconds: 10
  failureThreshold: 30                # 최대 약 5분 대기

readinessProbe:
  httpGet:
    path: /actuator/health/readiness  # 트래픽 수신 가능 여부만
  periodSeconds: 10

livenessProbe:
  httpGet:
    path: /actuator/health/liveness   # 앱 생존 여부만
  periodSeconds: 10

flowchart LR
    P1[Pod 1 Warm-up] --> DB[(DB)]
    P2[Pod 2 Warm-up] --> DB
    P3[Pod 3 Warm-up] --> DB
    P4[Pod 4 Warm-up] --> DB

    DB -->|과부하| X[장애]

    style X fill:#dc2626,color:#fff

gdoc_arrow_left_alt JVM Pod 재시작 시 초기 요청 실패, StartupProbe로 해결하기 ingress-nginx EOL: 88개 Ingress를 어디로 옮길 것인가 gdoc_arrow_right_alt