📗 개요 - StorageClass - K8S

🏳️‍🌈 [궁금한점]

• StorageClass 용도

---

🔗[목차]

• 1️⃣ 개요 / 기능
  • StorageClass 기능
    • 자동으로 스토리지 생성
    • 스토리지 종류 및 설정 지정
    • 접근 모드 및 볼륨 속성 설정
    • 재사용이 가능함
• 2️⃣ 정의
  • StorageClass 정의
    • Provisioner
    • volumeBindingMode
    • reclaimPolicy 옵션
• 3️⃣ 사용 방법
  • PVC 가 StorageClass 사용 예시
• 4️⃣ 활용
  • StorageClass 활용법

1️⃣ 개요 / 기능

StorageClass 기능

StorageClass는 Kubernetes에서 동적 프로비저닝을 가능하게 해주는 리소스이다.사용자가 PVC(PersistentVolumeClaim)를 만들면, PVC가 참조하는 StorageClass에 따라 알맞은 PV가 자동으로 생성된다.

자동으로 스토리지 생성

사용자가 PVC만 만들면 Kubernetes가 알아서 적절한 스토리지를 생성함.

예: AWS에서는 EBS, GCP에서는 Persistent Disk, Ceph, NFS 등 다양한 백엔드 지원.

스토리지 종류 및 설정 지정

다른 성능/속도/가격을 가진 여러 스토리지 유형 정의 가능.

예: fast, standard, slow 같은 StorageClass를 정의하고, 필요에 따라 선택 가능.

접근 모드 및 볼륨 속성 설정

볼륨의 reclaimPolicy, volumeBindingMode, parameters 등을 세부 설정 가능.

예: ReadWriteOnce, ReadOnlyMany, Retain, Delete 정책 등.

재사용이 가능함

한번 정의하면 여러 PVC에서 해당 StorageClass를 재사용할 수 있어 일관된 스토리지 전략 구현 가능.

2️⃣ 정의

StorageClass 정의

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: local-storage
provisioner: kubernetes.io/no-provisioner
reclaimPolicy: Retain                    
volumeBindingMode: WaitForFirstConsumer  
allowVolumeExpansion: true               

Provisioner

스토리지 종류	Provisioner 이름	비고
AWS EBS	ebs.csi.aws.com	EBS CSI Driver 필요
GCP PD	pd.csi.storage.gke.io	GKE에 내장
NFS	nfs.csi.k8s.io or nfs-client	외부 NFS 서버 필요
Ceph RBD	rbd.csi.ceph.com	CephCluster 연동
Longhorn	driver.longhorn.io	Longhorn 설치 필요
Local Path	k8s.io/minikube-hostpath or rancher.io/local-path	로컬 디스크 테스트용

volumeBindingMode

모드	설명
Immediate	PVC를 생성하면 즉시 PV 바인딩 시도
WaitForFirstConsumer	PVC가 연결된 Pod이 스케줄링될 때 PV 생성 및 바인딩 수행 → 노드 지역 고려 가능

reclaimPolicy 옵션

모드	설명
Delete	PVC 삭제 시 PV도 삭제
Retain	PVC 삭제 후 PV는 남겨둠 (데이터 보존)
Recycle	deprecated (간단한 초기화 후 재사용)

3️⃣ 사용 방법

PVC 가 StorageClass 사용 예시

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-data
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 5Gi
  storageClassName: local-storage

4️⃣ 활용

StorageClass 활용법

• 관리자: StorageClass 정의 (스토리지 종류/정책 포함)
• 개발자: PVC에서 storageClassName 지정 → 필요 시 Pod에 마운트
• Kubernetes: CSI 드라이버를 통해 자동으로 스토리지 프로비저닝
• 사용자: Pod에서 스토리지 사용, 삭제 정책 등에 따라 자동 정리