Skip to content

REL-005 Probe(Startup, Readiness, Liveness) 적용

Meaning

Kubernetes에서는 애플리케이션의 상태를 주기적으로 확인하기 위해 3가지 Probe를 제공합니다.

  • startupProbe: 앱 시작 확인컨테이너 내의 애플리케이션이 시작되었는지를 나타냅니다. 스타트업 프로브(startup probe)가 주어진 경우, 성공할 때까지 다른 나머지 프로브는 활성화되지 않습니다. 만약 스타트업 프로브가 실패하면, kubelet이 컨테이너를 죽이고, 컨테이너는 재시작 정책에 따라 처리됩니다. 컨테이너에 스타트업 프로브가 없는 경우, 기본 상태는 Success 입니다.
  • readinessProbe: 앱 준비 상태 확인컨테이너가 요청을 처리할 준비가 되었는지 여부를 나타냅니다. 만약 준비성 프로브(readiness probe)가 실패한다면, 엔드포인트 컨트롤러는 파드에 연관된 모든 서비스들의 엔드포인트에서 파드의 IP주소를 제거합니다. 준비성 프로브의 초기 지연 이전의 기본 상태는 Failure 입니다. 만약 컨테이너가 준비성 프로브를 지원하지 않는다면, 기본 상태는 Success 입니다.
  • livenessProbe: 앱 동작 상태 확인컨테이너가 동작 중인지 여부를 나타냅니다. 만약 활성 프로브(liveness probe)에 실패한다면, kubelet은 컨테이너를 죽이고, 해당 컨테이너는 재시작 정책의 대상이 됩니다. 만약 컨테이너가 활성 프로브를 제공하지 않는 경우, 기본 상태는 Success 입니다.

이 Probe들을 활용하면 애플리케이션의 신뢰성과 자동 복구 능력을 높일 수 있으며, 실제 서비스 중단 없이 장애 대응이 가능해집니다.

Impact

  • 서비스 안정성 향상: readinessProbe는 준비되지 않은 앱으로의 트래픽 전달을 방지합니다.
  • 빠른 복구: livenessProbe로 빠르게 문제를 감지하고 앱을 재시작할 수 있습니다.
  • 느린 부팅 보호: startupProbe로 앱이 준비될 때까지 다른 프로브가 작동하지 않도록 할 수 있습니다.

Diagnosis

모든 파드에서 Probe가 설정되지 않은 컨테이너를 확인합니다.

kubectl get pods --all-namespaces -o json | jq -r '
  .items[] | select(.metadata.namespace != "kube-system") | .spec.containers[] |
  select((has("startupProbe") | not) or (has("readinessProbe") | not) or (has("livenessProbe") | not)) |
  "Namespace: \(.metadata.namespace) | Pod: \(.metadata.name) | Container: \(.name) (미설정: \(.missing))"'

Mitigation

파드 정의에 startupProbe, readinessProbe, livenessProbe를 설정합니다.

example 

apiVersion: v1
kind: Pod
metadata:
  name: example-pod
spec:
  containers:
    - name: example-container
      image: my-app-image
      startupProbe:
        httpGet:
          path: /healthz
          port: 8080
        initialDelaySeconds: 10
        periodSeconds: 5
      readinessProbe:
        httpGet:
          path: /readiness
          port: 8080
        initialDelaySeconds: 5
        periodSeconds: 5
      livenessProbe:
        httpGet:
          path: /liveness
          port: 8080
        initialDelaySeconds: 15
        periodSeconds: 10
Probe 사용법