88. 스테이트풀셋 (StatefulSet) - K8s 상태 저장 DB 배포

핵심 인사이트 (3줄 요약)

본질: 스테이트풀셋 (StatefulSet)은 K8s (Kubernetes) 환경에서 파드(Pod)의 식별자와 스토리지 볼륨을 영구적으로 보장하는 워크로드 컨트롤러다.

가치: 파드가 재시작되거나 재생성되더라도 항상 동일한 이름(Ordinal Index)과 동일한 데이터 볼륨을 할당받아, 데이터 유실과 분산 시스템의 합의 붕괴를 원천 차단한다.

판단 포인트: 무상태(Stateless) 웹 서버나 API는 Deployment로 배포하고, 데이터베이스나 메시지 큐처럼 고유한 정체성과 상태 유지가 필수적인 시스템은 StatefulSet을 채택해야 한다.

Ⅰ. 개요 및 필요성

스테이트풀셋 (StatefulSet)은 파드 간의 순서와 고유성을 보장하여 상태 저장(Stateful) 애플리케이션을 안정적으로 운영하기 위한 쿠버네티스 객체다. 기존 Deployment는 파드를 언제든 대체 가능한 소모품으로 취급하기 때문에, 파드가 재시작되면 이름과 IP가 바뀌고 기존 디스크와의 연결도 끊어진다.

데이터베이스 클러스터나 메시지 브로커처럼 각 노드가 "자신이 누구인지"와 "어떤 데이터를 들고 있는지"를 기억해야 하는 분산 시스템에서는 이러한 무상태 철학이 치명적인 장애를 유발한다. 따라서 파드가 죽고 다시 살아나도 어제와 똑같은 이름과 데이터를 돌려주는 엄격한 배정 시스템이 필요해졌고, 이를 위해 StatefulSet이 등장했다.

📢 섹션 요약 비유: 무상태 파드가 이름표 없이 언제든 교체되는 공장 노동자라면, 상태 저장 파드는 자기 전용 금고와 고정된 직통 번호를 가진 은행 지점장과 같다.

Ⅱ. 아키텍처 및 핵심 원리

StatefulSet은 고정된 식별자, 헤드리스 서비스(Headless Service), 그리고 개별 영구 볼륨이라는 3대 요소를 결합하여 파드의 정체성을 유지한다.

구성 요소	핵심 역할	동작 원리 및 효과
Ordinal Identity	파드의 순차적 명명	`mysql-0`, `mysql-1`처럼 인덱스가 부여되며, 재기동 시에도 동일 이름 유지
Headless Service	고유한 네트워크 신원 제공	파드마다 개별 `DNS (Domain Name System)` 레코드를 생성하여 직접 통신 지원
VolumeClaimTemplates	파드별 영구 볼륨 할당	파드 생성 시 각각 독립적인 `PVC (PersistentVolumeClaim)`를 자동 생성

┌──────────────────────────────────────────────────────────────┐
│           StatefulSet의 정체성 및 볼륨 바인딩 구조           │
├──────────────────────────────────────────────────────────────┤
│  [StatefulSet Controller]                                    │
│       │                                                      │
│       ├─▶ Pod: web-0 ──DNS: web-0.svc──▶ PVC: data-web-0     │
│       │                                                      │
│       ├─▶ Pod: web-1 ──DNS: web-1.svc──▶ PVC: data-web-1     │
│       │                                                      │
│       └─▶ Pod: web-2 ──DNS: web-2.svc──▶ PVC: data-web-2     │
└──────────────────────────────────────────────────────────────┘

생성과 확장은 인덱스가 0인 파드부터 순차적으로 이루어지며(0 → 1 → 2), 이전 파드가 완전히 Running 및 Ready 상태가 되어야 다음 파드를 시작한다. 축소 및 삭제는 반대 순서(2 → 1 → 0)로 진행되어 데이터 동기화의 충돌을 방지한다.

📢 섹션 요약 비유: 아파트 입주처럼 101호가 지어지고 입주가 끝나야 102호를 짓고, 철거할 때는 102호부터 안전하게 비우는 순차적 건설 방식이다.

Ⅲ. 비교 및 연결

StatefulSet을 정확히 이해하려면 무상태 워크로드를 관리하는 Deployment와의 경계 비교가 필수적이다. 파드를 다루는 철학 자체가 다르기 때문이다.

비교 축	Deployment	StatefulSet
파드 명명 규칙	무작위 해시 (예: `web-7abc-x2`)	고정된 순차 번호 (예: `web-0`, `web-1`)
볼륨 마운트	모든 파드가 동일 볼륨 공유 가능	파드마다 1:1 고유 PVC 할당
시작 및 종료 순서	동시다발적 병렬 처리	엄격한 순차적 처리
적합한 워크로드	웹 서버, 마이크로서비스 API	DB 클러스터, `Kafka`, `ZooKeeper`

이러한 차이로 인해 StatefulSet은 스토리지 관리(StorageClass 연동)와 DNS 해상도(Headless Service)가 반드시 함께 설정되어야 정상 동작한다. 네트워크 계층과 스토리지 계층을 모두 결합해야 비로소 '상태'가 완성되기 때문이다.

📢 섹션 요약 비유: Deployment가 렌터카 풀에서 아무 차나 꺼내 타는 것이라면, StatefulSet은 번호판과 트렁크 짐이 항상 일치하는 개인 소유 차량을 배정하는 것이다.

Ⅳ. 실무 적용 및 기술사 판단

실무에서 StatefulSet은 데이터 정합성이 생명인 인프라 컴포넌트를 쿠버네티스 위로 올릴 때 핵심적인 의사결정 대상이 된다.

💡 기술사 판단 (체크리스트)

워크로드 특성 검토: 파드 이름이나 IP가 변경되었을 때, 클러스터 합의 알고리즘(예: Raft, Paxos)이 깨지는가?
볼륨 생명주기 분리 확인: StatefulSet을 삭제해도 PVC는 기본적으로 보존된다. 삭제 시 데이터까지 지울 것인지에 대한 백업 및 정리 정책이 수립되었는가?
Headless Service 매핑: 로드밸런싱이 목적이 아니라 파드 간 다이렉트 통신이 목적이므로, clusterIP: None 설정이 누락되지 않았는가?

🚫 안티패턴

임시 볼륨 사용: 볼륨 템플릿에 emptyDir을 사용하여, 파드 재시작 시 데이터가 날아가게 구성하는 설계.
무조건적인 StatefulSet 도입: 단순히 파일 캐시를 저장하려고 StatefulSet을 남용하는 행위. 상태 저장은 관리형 클라우드 DB에 맡기고, K8s는 무상태로 유지하는 것이 운영 부담을 줄이는 길이다.
📢 섹션 요약 비유: 중요한 서류를 보관할 때는 임시 사물함(emptyDir)이 아니라, 이름표가 붙고 자물쇠가 확실한 개인 전용 금고(PVC와 StatefulSet)에 넣어야 한다.

Ⅴ. 기대효과 및 결론

StatefulSet을 적절히 활용하면, 재난 복구와 노드 장애 시에도 분산 데이터베이스의 데이터 정합성과 네트워크 신원(Identity)이 완벽하게 보장된다. 이는 쿠버네티스가 단순 컨테이너 오케스트레이션을 넘어 스테이트풀 인프라 플랫폼으로 확장되는 기반을 제공한다.

하지만 파드의 자동 교체가 제한되고 순차적 처리로 인해 배포 속도가 느려지며, 스토리지 관리에 대한 운영 복잡도가 크게 상승한다는 한계가 있다. 결론적으로 StatefulSet은 "무조건 피해야 할 것도, 무조건 써야 할 것도 아니며, 애플리케이션이 상태의 영속성을 스스로 책임져야만 할 때 사용하는 최후의 보루"로 인식해야 한다.

📢 섹션 요약 비유: 절대 자리를 뜨면 안 되는 초소 경비병처럼, 배치와 철수가 까다롭지만 그 덕분에 진지(데이터)가 흔들리지 않게 지켜내는 핵심 방어선이다.

📌 관련 개념 맵

개념	연결 포인트
Headless Service	`clusterIP: None`으로 설정되어, 로드밸런싱 없이 파드 개별의 DNS 레코드를 직접 반환
PVC (PersistentVolumeClaim)	StatefulSet의 `VolumeClaimTemplates`에 의해 파드별로 동적 프로비저닝되는 영구 스토리지
Operator Pattern	StatefulSet만으로 부족한 DB 백업, 복구, 버전 업그레이드 등 복잡한 상태 관리를 자동화하는 패턴
DaemonSet	상태와 무관하게 모든 노드에 1개씩 떠야 하는 로그/모니터링 에이전트 워크로드

📈 관련 키워드 및 발전 흐름도

[무상태 워크로드 관리]
Deployment / ReplicaSet (일회성 파드)
        │
        ▼
[상태 의존성 문제 발생]
네트워크 신원 변경 및 볼륨 공유 충돌
        │
        ▼
[상태 저장 제어기 도입]
StatefulSet (고정 Ordinal Index)
        │
        ▼
[정체성 및 데이터 영속성 결합]
Headless Service (고정 DNS) + VolumeClaimTemplates (고유 PVC)
        │
        ▼
[고도화된 상태 관리]
Kubernetes Operator (DB 특화 자동화)

👶 어린이를 위한 3줄 비유 설명

놀이공원 범퍼카는 아무나 빈 차에 타면 되지만(Deployment), 지정 좌석제 버스는 자기 이름표가 있는 자리에만 앉아야 해요.
스테이트풀셋(StatefulSet)은 파드라는 친구들에게 '지정 좌석'과 '자기만의 서랍'을 영원히 만들어주는 선생님이에요.
그래서 컴퓨터가 잠깐 꺼졌다 켜져도, 항상 원래 내 자리에서 원래 내 물건을 그대로 찾을 수 있답니다!