StatefulSets
최종 수정: 2026. 1. 19.
StatefulSets
StatefulSet은 상태 저장 애플리케이션을 관리하기 위한 워크로드 리소스입니다.
개요
StatefulSet의 특징:
- 안정적인 고유 네트워크 식별자
- 안정적인 영구 스토리지
- 순서 보장된 배포 및 스케일링
- 순서 보장된 자동 롤링 업데이트
Deployment와 차이점
| 특성 | Deployment | StatefulSet |
|---|---|---|
| Pod 이름 | 랜덤 해시 | 순차 인덱스 (app-0, app-1) |
| 스토리지 | 공유 | Pod별 전용 PVC |
| 스케일링 | 병렬 | 순차 |
| 삭제 | 병렬 | 역순차 |
StatefulSet 목록
접근 방법
- 사이드바에서 Workloads > StatefulSets 선택
- 현재 네임스페이스의 모든 StatefulSet 표시
목록 컬럼
| 컬럼 | 설명 |
|---|---|
| Name | StatefulSet 이름 |
| Namespace | 네임스페이스 |
| Ready | Ready 상태인 Pod 수 |
| Desired | 목표 Pod 수 |
| Age | 생성 후 경과 시간 |
Overview 탭
자세히 보고싶은 행을 클릭하면 상세보기 화면이 열립니다
조작
상세보기 화면우측 상단의 버튼 클릭시 조작 메뉴가 열립니다
Edit
StatefulSet YAML을 직접 편집합니다.
참고:
spec.volumeClaimTemplates는 생성 후 수정할 수 없습니다.
Restart
모든 Pod를 순차적으로 재시작합니다.
참고: 내부적으로 Pod 템플릿에
kubectl.kubernetes.io/restartedAt어노테이션을 추가하여 롤아웃을 트리거합니다.
Scale
레플리카 수를 조정합니다.
참고: OrderedReady 정책에서는 이전 Pod가 Ready 상태가 되어야 다음 Pod가 생성됩니다.
Delete
StatefulSet과 관련 Pod를 삭제합니다.
주의: PVC는 기본적으로 보존됩니다. 데이터를 완전히 삭제하려면 PVC를 별도로 삭제해야 합니다.