Use Case 2. Pod 삭제 과정 - 내부 동작 분석

📎 참고 자료: https://lnkd.in/gaqp7-Xg

kubectl delete pod 를 실행하면 내부에서 어떤 일이 일어나는지, 그리고 왜 Graceful Shutdown 설정이 중요한지 살펴봅니다.

1. 전체 흐름

    sequenceDiagram
    participant U as kubectl
    participant A as API Server
    participant E as etcd
    participant K as kubelet
    participant EP as EndpointSlice Controller
    participant P as kube-proxy
    U->>A: DELETE pod
    A->>E: deletionTimestamp 설정 (Terminating)
    par 트래픽 차단
        EP->>EP: Pod 를 EndpointSlice 에서 제거
        EP-->>P: 엔드포인트 변경 전파
    and 컨테이너 종료
        K->>K: preStop hook 실행
        K->>K: SIGTERM 전송
        K->>K: terminationGracePeriodSeconds 대기
        K->>K: 미종료 시 SIGKILL
    end
    K->>A: Pod 종료 보고
    A->>E: Pod 오브젝트 최종 삭제
  

1. 삭제 요청: API Server 가 Pod 를 즉시 지우지 않고 metadata.deletionTimestamp 를 설정합니다 (상태: Terminating).
2. Endpoint 제거: EndpointSlice 컨트롤러가 Service 의 백엔드 목록에서 Pod 를 제거합니다.
3. kubelet 종료 처리: preStop 훅 → SIGTERM → 유예 시간 대기 → SIGKILL.
4. 최종 삭제: kubelet 이 종료를 보고하면 API Server 가 etcd 에서 오브젝트를 삭제합니다.

⚠️ 2번과 3번은 병렬로 진행됩니다. 즉 엔드포인트 전파가 끝나기 전에 SIGTERM 이 도착할 수 있고, 이때 일부 요청이 종료 중인 Pod 로 유입될 수 있습니다.

2. 중요한 설정

spec:
  terminationGracePeriodSeconds: 30   # 기본값 30초
  containers:
  - name: app
    lifecycle:
      preStop:
        exec:
          command: ["sh", "-c", "sleep 5"]   # 엔드포인트 전파 시간을 벌어줌

3. Pod 가 Terminating 에서 멈출 때

kubectl delete pod <name> --grace-period=0 --force   # 최후의 수단

4. 정리

삭제 = deletionTimestamp 설정 → Endpoint 제거 + (preStop → SIGTERM → SIGKILL) → etcd 삭제. 무중단 배포를 원한다면 preStop sleep 과 SIGTERM 핸들링을 반드시 설계하세요.