yceffort
◆ SERIES 6 POSTS

프론트엔드 개발자가 알아야 할 쿠버네티스

SSR을 운영하는 프론트엔드 개발자가 쿠버네티스를 블랙박스로 두지 않기 위해, kind 클러스터에서 직접 열어보고 실측한 기록

README

SSR을 운영하다 보면 배포, 트래픽, 메모리 같은 문제의 절반은 애플리케이션 바깥, 그러니까 쿠버네티스 쪽에서 벌어진다. 그런데 프론트엔드 개발자 입장에서 쿠버네티스는 대체로 남이 만들어 둔 매니페스트를 복사해 쓰는 블랙박스로 남기 쉽다. 이 시리즈는 그 블랙박스를 한 층씩 직접 열어본 기록이다.

각 편은 개념 설명에서 멈추지 않고 kind 클러스터와 실제 Next.js 앱으로 직접 재현하고 측정하는 것을 원칙으로 했다. 이미지 레이어에서 사라진 1.5GB를 역추적하고, ClusterIP라는 어디에도 없는 IP에 curl이 닿는 경로를 iptables 규칙으로 따라가고, 롤링 배포 중 새는 에러를 0으로 만들 때까지 처방을 한 층씩 얹는 식이다.

첫 편이 전체 개념 지도 역할을 하므로, 쿠버네티스가 처음이라면 순서대로 읽는 쪽을 권한다. 특정 문제를 겪고 있다면 해당 편만 읽어도 되도록 각 편을 독립적으로 구성했다.

06 ITEMS

전체 글

in order
01

프론트엔드 개발자를 위한 쿠버네티스 개념 지도: 파드에서 오토스케일러까지

#kubernetes#devops
SSR을 운영하는 프론트엔드 개발자를 위해 클러스터 구성, 배포, 파드의 상태와 자원, 트래픽 경로, 오토스케일링 순서로 정리한 쿠버네티스 핵심 개념
수정
40분
02

내 Next.js 앱은 어떻게 파드가 되는가: 컨테이너와 파드를 직접 열어본 기록

#kubernetes#docker#devops
같은 Next.js 앱으로 만든 1.72GB와 208MB짜리 두 이미지. 사라진 1.5GB를 레이어에서 역추적하고, 컨테이너가 격리된 프로세스라는 것을 PID와 cgroup 파일로 직접 확인해보기
수정
34분
03

트래픽은 어떻게 내 파드에 도착하는가: ClusterIP부터 port-forward까지

#kubernetes#networking#devops
Service의 ClusterIP는 어느 기계에도 붙어 있지 않은 IP인데 curl 요청은 어떻게 파드에 도착할까. kind 클러스터에서 iptables 규칙과 conntrack, EndpointSlice, 클러스터 DNS의 ndots, Gateway, port-forward를 차례로 확인하며 요청 경로 따라가기
수정
48분
04

파드는 어떻게 종료되는가: 배포 중 에러의 원인과 해결을 실측한 기록

#kubernetes#devops#debugging
코드를 한 줄도 바꾸지 않은 배포에서도 생기는 요청 실패. 롤링 배포 중 실패한 요청을 유형과 시각으로 태깅해 찾은 원인 네 가지, 해법을 하나씩 더해 실패를 0건으로 줄인 순서, Next.js의 종료 처리 코드와 CrashLoopBackOff의 실제 재시작 간격
수정
36분
05

오토스케일링은 자동이지만 즉시가 아니다: HPA의 시간을 구간별로 실측한 기록

#kubernetes#devops#web-performance
트래픽을 12배로 올렸을 때 새 파드가 첫 요청을 받기까지 걸린 31.5초와, 그중 HPA가 부하를 알아채는 데 쓴 22.5초. 배포 직후 5분 동안 오토스케일러가 반응하지 못하는 조건, 스케일 다운이 계단식으로 내려오는 이유, 메모리 기준 HPA가 Node 앱에 맞지 않는 이유, KEDA로 미리 확장하는 방법
수정
40분
06

Node.js 파드는 왜 그 크기인가: NODE_OPTIONS부터 파드 수까지 직접 재본 사이징

#memory#nodejs#kubernetes
같은 워크로드에 GC 튜닝 플래그 한 줄을 붙였더니 살아 있는 데이터는 그대로인데 201MB에서 593MB로 늘어난 peak RSS. V8 New Space를 직접 측정해 그 이유를 따라가며 정리한, 프론트엔드 개발자를 위한 Node.js 파드 사이징의 세 가지 기준
수정
84분