본문으로 건너뛰기

StorageClass 관리

관리자는 대시보드 UI에서 StorageClass를 직접 등록·조회·삭제하고, 볼륨 생성 시 선택 목록에 노출할 기본(Default) StorageClass를 지정할 수 있습니다.

관리자 전용

이 메뉴는 nufi-admin 역할이 부여된 계정에서만 표시됩니다.

StorageClass 목록​

좌측 사이드바의 Admin > Storage 항목을 클릭합니다.

Admin StorageClass 목록

컬럼

컬럼설명
NameStorageClass 이름
Type스토리지 유형 (NFS / Local Path 등)
Provisioner프로비저너 이름
Reclaim PolicyPV 해제 시 처리 방식 (Retain / Delete)
VolumeCount이 StorageClass로 생성된 Volume 수
Default기본 StorageClass 여부 배지
System / Custom시스템 기본 제공 SC(System) 또는 관리자 추가 SC(Custom) 배지

액션 버튼

버튼대상설명
①Add StorageClass전체새 StorageClass 등록 페이지로 이동
②DefaultCustom SC해당 SC를 기본 StorageClass로 지정
③DeleteCustom SC해당 StorageClass 삭제 (System, Default SC는 삭제 불가)
StorageClass 수정 불가

StorageClass는 등록 후 수정할 수 없습니다. 변경이 필요한 경우 삭제 후 재등록하세요.

StorageClass 등록​

목록 페이지에서 + Add StorageClass 버튼을 클릭합니다.

Admin StorageClass 등록

등록 페이지는 폼 모드와 YAML 모드 두 가지를 지원합니다. 상단 탭에서 전환할 수 있습니다.

폼 모드​

필드설명
NameStorageClass 이름 (소문자, 숫자, 하이픈)
Type스토리지 유형 선택 (NFS / Local Path)
Reclaim PolicyPV 해제 시 데이터 처리 방식. Retain: 볼륨 삭제 후에도 데이터를 보존합니다. 프로덕션 환경에 권장합니다. Delete: 볼륨 삭제 시 데이터도 함께 삭제됩니다. 테스트 환경에 적합합니다.
Set as Default체크 시 볼륨 생성 폼의 기본 선택값으로 지정

NFS 선택 시 추가 필드:

필드설명
ServerNFS 서버 주소 (예: 192.168.1.100)
Share PathNFS 공유 경로 (예: /data/shared)

Local Path 선택 시 추가 필드:

필드설명
Node Path노드의 로컬 디렉토리 경로 (예: /mnt/local-storage)

YAML 모드​

StorageClass 매니페스트를 YAML로 직접 입력합니다. NFS / Local Path 외의 커스텀 Provisioner를 사용하거나 mountOptions, allowVolumeExpansion 같은 고급 파라미터를 지정해야 할 때 사용합니다.

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: custom-sc
provisioner: example.com/my-provisioner
reclaimPolicy: Retain
allowVolumeExpansion: true
parameters:
  type: ssd

볼륨 생성 폼과의 연동​

등록된 StorageClass는 Volumes > Create 페이지의 Storage Class 드롭다운에 자동으로 표시됩니다. NFS 또는 Local Path 타입의 SC를 선택하면 정적 프로비저닝용 Mount Path 입력 필드가 추가로 나타납니다.

다음 단계​