K8s 헬스 프로브 3종 선택 기준 (readiness/liveness/startup)

- livenessProbe: 연속 실패가 임계값에 이르면 kubelet이 컨테이너를 재시작한다. DB 등 외부 의존성 장애를 생존 실패로 취급하지 않는다. - readinessProbe: 실패하면 Pod가 Ready가 아니게 되어 Service 트래픽 대상에서 제외된다. 이 실패만으로 컨테이너를 재시작하지는 않는다. 엔드포인트 갱신·트래픽 중단이 즉각적이라고 가정하지 않는다. - startupProbe: 성공할 때까지 해당 컨테이너의 liveness/readi

Summary#

livenessProbe: 연속 실패가 임계값에 이르면 kubelet이 컨테이너를 재시작한다. DB 등 외부 의존성 장애를 생존 실패로 취급하지 않는다.
readinessProbe: 실패하면 Pod가 Ready가 아니게 되어 Service 트래픽 대상에서 제외된다. 이 실패만으로 컨테이너를 재시작하지는 않는다. 엔드포인트 갱신·트래픽 중단이 즉각적이라고 가정하지 않는다.
startupProbe: 성공할 때까지 해당 컨테이너의 liveness/readiness 검사를 시작하지 않는다. 임계 횟수만큼 실패하면 재시작될 수 있으므로 failureThreshold × periodSeconds를 초기화 허용 시간의 대략적인 설계 기준으로 삼고 timeout과 스케줄링 영향도 고려한다.

FastAPI 예시#

livenessProbe:
  httpGet:
    path: /health/live    # 저비용 로컬 생존 확인
    port: 8000
  periodSeconds: 10
  failureThreshold: 3
readinessProbe:
  httpGet:
    path: /health/ready   # 이 인스턴스가 트래픽을 받을 수 있는가
    port: 8000
  periodSeconds: 5
  failureThreshold: 2
startupProbe:
  httpGet:
    path: /health/startup # 필요한 초기화가 끝났을 때만 성공
    port: 8000
  periodSeconds: 10
  failureThreshold: 30

/health/live가 초기화 완료 전에도 성공한다면 startupProbe에 재사용해서는 안 된다. 반대로 생존 확인 성공이 곧 필요한 초기화 완료를 뜻하는 애플리케이션이라면 재사용할 수 있다. /health/ready의 의존성 확인은 실제 트래픽 수용 가능성에 필요한 범위로 제한한다. readiness만으로 무중단 배포가 보장되지는 않으며 롤링 업데이트 설정과 종료 시 드레인도 함께 설계한다.

personal_vault/projects/ops/librarian/capsules/Kubernetes Probe Failure Modes: startupProbe, readiness/liveness semantics, slow-boot shielding, and sidecar/termination edge cases.md: 프로브별 실패 동작, 초기화 보호, 종료 시 트래픽 드레인 맥락.

Sagwan Revalidation 2026-09-28T10:30:34Z#

verdict: ok
note: 프로브별 동작과 설정 지침이 여전히 유효하며, 수정할 오류가 보이지 않는다.

Sagwan Revalidation 2026-10-02T14:23:56Z#

verdict: ok
note: 프로브별 동작과 설정 지침이 여전히 유효하며 수정할 오류가 보이지 않는다.

Sagwan Revalidation 2026-10-05T15:23:09Z#

verdict: ok
note: 프로브별 동작과 설정 지침이 현재도 유효하며 수정할 오류가 보이지 않는다.

Sagwan Revalidation 2026-10-08T14:35:29Z#

verdict: ok
note: 세 프로브의 동작 설명과 설정 지침이 현재도 유효하며 수정할 오류가 보이지 않는다.

Sagwan Revalidation 2026-10-11T09:04:17Z#

verdict: ok
note: 세 프로브의 동작과 설정 지침이 여전히 유효하며, 수정할 오류가 보이지 않는다.

Sagwan Revalidation 2026-10-14T02:51:29Z#

verdict: ok
note: 세 프로브의 동작과 선택 기준이 여전히 유효하며, 수정할 오류가 보이지 않는다.

Sagwan Revalidation 2026-10-16T23:09:15Z#

verdict: ok
note: 프로브별 동작과 설정 지침이 유효하며, 수정할 오류가 보이지 않는다.

Sagwan Revalidation 2026-10-19T19:18:05Z#

verdict: ok
note: 세 프로브의 동작과 선택 기준이 여전히 유효하며, 수정할 오류가 보이지 않는다.