문서 목차
QKS · Workloads
StatefulSets
StatefulSet 은 상태 저장(stateful) 애플리케이션을 위한 Kubernetes 워크로드 오브젝트입니다. 각 Pod에 고유하고 예측 가능한 이름과 안정적인 네트워크 ID를 부여하며, Pod마다 독립된 퍼시스턴트 볼륨을 유지합니다.
QUANTUM C&S
개요
StatefulSet은 상태 저장(stateful) 애플리케이션을 위한 Kubernetes 워크로드 오브젝트입니다. 각 Pod에 고유하고 예측 가능한 이름과 안정적인 네트워크 ID를 부여하며, Pod마다 독립된 퍼시스턴트 볼륨을 유지합니다.
데이터베이스, 메시지 큐, 분산 캐시 등 상태를 유지해야 하는 애플리케이션에 StatefulSet을 사용합니다.
Deployment와의 차이
| 항목 | Deployment | StatefulSet |
|---|---|---|
| Pod 이름 | 임의 해시 포함 | 순서 번호 포함 (app-0, app-1, ...) |
| 스토리지 | 공유 또는 없음 | Pod별 독립 PVC |
| 시작/종료 순서 | 병렬 | 순차적 |
| 용도 | 상태 비저장 앱 | 상태 저장 앱 |
QKS 콘솔에서 StatefulSet 확인
- 왼쪽 메뉴에서 Workloads > StatefulSets를 선택합니다.
- 네임스페이스를 선택하면 StatefulSet 목록이 표시됩니다.
- 각 StatefulSet의 이름, 준비된 파드 수, 전체 파드 수, 생성 시간을 확인합니다.
kubectl로 관리
# StatefulSet 목록 확인
kubectl get statefulsets -n <namespace>
# 특정 StatefulSet 상세 정보
kubectl describe statefulset <name> -n <namespace>
# 스케일 조정
kubectl scale statefulset/<name> --replicas=<count> -n <namespace>
# 롤아웃 상태 확인
kubectl rollout status statefulset/<name> -n <namespace>