Volumes

PVC(PersistentVolumeClaim) 기반 Volume을 생성하고 Lab·Serving에 마운트하여 모델 파일, 데이터셋 등을 공유하는 방법을 안내합니다.

Volume 목록

좌측 사이드바에서 Volumes를 클릭하면 현재 프로젝트의 Volume 목록이 표시됩니다.

컬럼

컬럼	설명
Name	Volume 이름
Size	Volume 용량
Access Mode	Volume 접근 방식 (RWX 등)
Status	PVC 바인딩 상태 (Bound / Pending 등)
Used By	이 Volume을 마운트 중인 Lab / Serving 목록
Created	생성된 시각

---

Volume 생성

1. Volume 목록 페이지 우측 상단의 Create 버튼을 클릭합니다.
2. 생성 폼에 필요한 정보를 입력합니다.

필드	설명
Name	Volume 이름 (소문자, 숫자, 하이픈 / 프로젝트 내 고유)
Storage Class	클러스터에 존재하는 StorageClass 중 하나를 선택합니다. StorageClass 리소스 생성/관리는 Kubernetes 관리자 또는 클러스터 운영 도구에서 수행합니다.
Size	Volume 용량 (예: 10Gi)

선택한 StorageClass에 최대 용량 제한이 설정되어 있으면 폼 아래에 Max Size 안내가 표시되며, 이 값을 초과하는 Volume 생성 요청은 차단됩니다.

3. Create 버튼을 클릭합니다.

Volume 리사이즈

Volume은 생성 후 크기를 변경이 가능합니다. Volume 생성 후 용량이 부족한 경우 Volume 상세 페이지에서 resizing 기능을 이용하세요.

---

Volume 상세 페이지

Volume 목록에서 항목을 클릭하면 상세 페이지로 이동합니다.

Overview

카드	정보
Status	Status (PVC 바인딩 상태), Access Mode
Storage	Size, Storage Class, Max Size, Usage
Used By	이 Volume을 마운트 중인 Lab / Serving 목록
Created	생성 시간

Max Size는 해당 Storage Class에서 허용하는 Volume의 최대 크기입니다. Storage Class에 최대 크기 제한이 설정된 경우에만 표시되며, Volume 생성이나 크기 조정 시 이 값을 초과하는 용량은 요청할 수 없습니다.

Volume 크기 조정 (Resize)

Storage 카드의 Size 항목 옆 **편집 아이콘(연필)**을 클릭하면 Volume 용량을 늘릴 수 있습니다. 이 아이콘은 Volume이 Bound 상태일 때만 표시됩니다.

Volume 크기를 조정하려면 다음 순서로 진행합니다.

1. Volume 목록에서 Bound 상태인 Volume 행을 클릭합니다.
2. Overview 탭의 Storage 카드에서 Size 항목 옆 편집 아이콘을 클릭합니다.
3. 새 크기를 숫자로 입력하고 단위(Mi/Gi/Ti)를 선택합니다.
4. 저장(✓) 아이콘을 클릭하여 적용합니다.

노트

• 현재 크기보다 큰 값만 입력 가능합니다 (축소 불가). 현재 크기 이하 값이나 StorageClass 최대 용량 초과 값을 입력하면 인라인 오류 메시지가 표시됩니다.
• 서버/Kubernetes 레벨의 오류는 토스트 메시지로 전달됩니다.

Files

파일 목록 조회, 업로드, 디렉토리 생성, 파일 이동·삭제 등의 파일 관리 작업을 웹 UI에서 바로 수행할 수 있습니다. Volume이 Bound 상태가 아니면 이 탭은 비활성화됩니다.

버튼	설명
Upload	로컬 파일을 Volume에 업로드
New Folder	새 폴더 생성

각 파일 또는 폴더 행의 우측 ... 버튼을 클릭하면 해당 항목에 대한 작업 메뉴가 열립니다.

메뉴	설명
Download / Download (.zip)	파일을 그대로 다운로드합니다. 폴더는 zip 파일로 압축하여 다운로드합니다.
Rename	같은 위치에서 파일 또는 폴더 이름을 변경합니다.
Move	파일 또는 폴더를 선택한 디렉토리로 이동합니다.
Delete	확인 후 파일 또는 폴더를 삭제합니다. 폴더를 삭제하면 하위 항목도 함께 삭제됩니다.

---

Volume 삭제

Volume 목록에서 삭제할 Volume 행의 휴지통 아이콘을 클릭한 뒤, 확인 다이얼로그에서 삭제를 확정합니다.

사용 중인 Volume 삭제 불가

현재 Lab 또는 Serving에서 마운트 중인 Volume은 삭제할 수 없습니다. 먼저 해당 리소스에서 Volume 연결을 해제한 후 삭제하세요.