StatefulSets

최종 수정: 2026. 1. 19.

StatefulSets

StatefulSet은 상태 저장 애플리케이션을 관리하기 위한 워크로드 리소스입니다.

개요

StatefulSet의 특징:

  • 안정적인 고유 네트워크 식별자
  • 안정적인 영구 스토리지
  • 순서 보장된 배포 및 스케일링
  • 순서 보장된 자동 롤링 업데이트

Deployment와 차이점

특성 Deployment StatefulSet
Pod 이름 랜덤 해시 순차 인덱스 (app-0, app-1)
스토리지 공유 Pod별 전용 PVC
스케일링 병렬 순차
삭제 병렬 역순차

StatefulSet 목록

접근 방법

  1. 사이드바에서 Workloads > StatefulSets 선택
  2. 현재 네임스페이스의 모든 StatefulSet 표시

목록 컬럼

컬럼 설명
Name StatefulSet 이름
Namespace 네임스페이스
Ready Ready 상태인 Pod 수
Desired 목표 Pod 수
Age 생성 후 경과 시간

Overview 탭

자세히 보고싶은 행을 클릭하면 상세보기 화면이 열립니다
스크린샷 2026-01-16 오후 6.53.27.png

조작

상세보기 화면우측 상단의 버튼 클릭시 조작 메뉴가 열립니다
스크린샷 2026-01-16 오후 6.53.17.png

Edit

StatefulSet YAML을 직접 편집합니다.

참고: spec.volumeClaimTemplates는 생성 후 수정할 수 없습니다.

Restart

모든 Pod를 순차적으로 재시작합니다.

참고: 내부적으로 Pod 템플릿에 kubectl.kubernetes.io/restartedAt 어노테이션을 추가하여 롤아웃을 트리거합니다.

Scale

레플리카 수를 조정합니다.

참고: OrderedReady 정책에서는 이전 Pod가 Ready 상태가 되어야 다음 Pod가 생성됩니다.

Delete

StatefulSet과 관련 Pod를 삭제합니다.

주의: PVC는 기본적으로 보존됩니다. 데이터를 완전히 삭제하려면 PVC를 별도로 삭제해야 합니다.