Apps Walkthrough — backend + hc + graceful-drain.sh

Sun, 07 Jun 2026 00:00:00 +0000

ABSTRACT

graceful termination은 “Pod를 끈다"가 단일 행위가 아니라, 서로 분리된 4개 신호(LB health, K8s readiness, Envoy listener, in-flight 요청)를 정해진 순서로 하나씩 끄는 것이라는 사실을 코드로 증명하는 문서다. 홈랩 실험의 두 Go 애플리케이션(apps/backend, apps/hc)과 preStop 훅(apps/hc/graceful-drain.sh)을 라인 수준까지 추적한다. 결론부터: backend는 끌 대상(in-flight 요청)을 만들고, hc FSM은 어떤 신호를 언제 끌지를 5-state로 인코딩하며, drain.sh는 그 순서를 best-effort로 오케스트레이션한다. 세 파일은 같은 한 문제의 세 측면이다. FSM/health 응답표·active=0 전략의 개요 정본은 W2 — HC FSM, Envoy drain 메커니즘 상세는 Envoy drain listeners에 둔다. 본 문서는 라인별 코드 추적에 집중한다.

W2. Backend + hc + drain.sh — Go 코드 메커니즘

Sun, 07 Jun 2026 00:00:00 +0000

ABSTRACT

머릿속에 담을 한 장: health endpoint의 응답 코드는 LB의 backend pool membership을 제어하는 원격 스위치다. hc 사이드카는 5-state FSM(OPEN/DRAINING/CLOSING/CLOSED/FAULT)으로 이 스위치를 쥐고, drain.sh는 “active=0 확인 전까지 /health_check.html 200 유지"로 스위치를 끄는 시점을 모든 요청 완료 이후로 밀어내 HAProxy가 in-flight 연결을 끊지 않게 한다. 본 문서는 이 동작을 멘탈 모델/왜 층에서 다루며, 라인별 정본 추적은 코드 워크스루(apps-walkthrough)에 위임한다.

Go on homelab89

Apps Walkthrough — backend + hc + graceful-drain.sh

W2. Backend + hc + drain.sh — Go 코드 메커니즘