Spaces 디스크 사용량

모든 Space에는 소량의 디스크 스토리지가 함께 제공돼요. 이 디스크 공간은 일시적(ephemeral)이라 Space가 재시작되거나 중지되면 내용이 손실돼요. Space 자체보다 더 긴 수명으로 데이터를 유지해야 한다면 하나 이상의 Storage Buckets을 볼륨으로 연결할 수 있어요.

영구 데이터는 반드시 볼륨으로 마운트한 Storage Bucket에 저장하세요.

출처: 문서

본문

연결된 볼륨 (Attached Volumes)

Storage Buckets은 Space에서 데이터를 유지하라고 권장하는 방식이에요. 연결된 버킷은 지정한 경로에 Space 컨테이너에 마운트되어, 런타임에 내용을 로컬 파일로 사용할 수 있게 해줘요.

버킷은 Space 생성 시, Space 설정 UI에서, 또는 huggingface_hub Python API로 프로그래밍 방식으로 연결할 수 있어요. 읽기-쓰기(기본) 또는 읽기 전용으로 마운트할 수 있어요.

버킷 생성·사용에 대한 전체 내용은 Storage Buckets 문서를 참고해요.

연결된 볼륨 보기

Space 페이지는 작업 드롭다운에서 연결된 볼륨을 표시해요. 각 볼륨은 소스 버킷, 컨테이너 내 마운트 경로, 읽기 전용인지 읽기-쓰기인지를 보여줘요.

모델, 데이터셋, 다른 Spaces 마운트하기

모델, 데이터셋, 다른 Spaces는 huggingface_hub Python API를 통해 볼륨으로 연결할 수 있어요. 항상 읽기 전용으로 마운트돼요.

연결되면 리포지토리 볼륨이 버킷과 함께 Space 작업 드롭다운에 나타나고 UI에서 보거나 마운트 해제할 수 있어요.

볼륨이 비공개 리포지토리를 참조할 때 접근 권한이 없는 사용자도 볼륨이 나열된 것(마운트 경로와 접근 모드 포함)을 볼 수 있지만, 소스는 "(private)" 라벨과 함께 ****/******로 마스킹돼요.

더 알아보기 (Learn more)

Space 기본 디스크는 일시적이에요 — 영구 데이터는 Storage Bucket 볼륨에 저장하세요.
버킷은 UI·생성 시·Python API로 읽기-쓰기 또는 읽기 전용 마운트할 수 있어요.
Storage Buckets 문서에서 생성·사용 전체를 확인해 보세요.