문서 목차
다운로드
HuggingFace 에서 모델·데이터셋을 가져오는 작업의 진행 상황을 한곳에서 보는 화면입니다. 가져오기는 서버에서 백그라운드로 진행되므로, 이 화면에서 진행률을 확인하고 실패한 작업을 다시 시작하거나 끝난 기록을 정리합니다.
QUANTUM C&S
HuggingFace 에서 모델 · 데이터셋을 가져오는 작업의 진행 상황을 한곳에서 보는 화면입니다. 가져오기는 서버에서 백그라운드로 진행되므로, 이 화면에서 진행률을 확인하고 실패한 작업을 다시 시작하거나 끝난 기록을 정리합니다.
이런 일을 할 수 있어요
- 모델 · 데이터셋 가져오기(임포트) 작업의 상태를 실시간으로 확인
- 상태별(전체 · 진행중 · 완료 · 실패/취소) 개수를 보고, 카드를 눌러 그 상태만 걸러 보기
- HuggingFace 저장소 ID 로 검색
- 진행 중인 작업 취소, 실패 · 취소된 작업 재시작
- 가져오기가 끝난 모델 · 데이터셋으로 바로 이동(모델 보기 / 데이터셋 보기)
- 끝난 작업 기록을 하나씩 또는 여러 개 골라 삭제
참고 가져오기 자체는 이 화면에서 시작하지 않습니다. 모델 레지스트리나 데이터셋 화면에서 HuggingFace 가져오기를 시작하면 그 작업이 여기에 나타납니다.
화면 구성
| 영역 | 설명 |
|---|---|
| 제목 옆 실시간 표시 | 서버와 실시간 연결이 되어 있으면 초록색 실시간, 연결 중이면 연결 중... 으로 보입니다. 연결되어 있으면 진행률이 새로고침 없이 바뀝니다. |
| 새로고침 | 목록을 다시 불러옵니다. |
| 상태 카드 | 전체 · 진행중 · 완료 · 실패/취소 개수. 카드를 누르면 그 상태의 작업만 목록에 남습니다. |
| 검색 | 검색 (HuggingFace repo ID) 칸에 org/name 일부를 넣어 거릅니다. |
| 전체 선택 | 현재 페이지의 작업을 한꺼번에 선택합니다. 선택하면 선택 삭제 버튼이 나타납니다. |
| 작업 카드 | 저장소 ID, 작업 종류(모델 임포트 · 모델 다운로드 · 데이터셋 임포트 · 데이터셋 다운로드), 상태 배지, 전체 크기 · 파일 수, 시작 · 완료 시각, 결과로 가는 링크 |
| 카드 오른쪽 아이콘 · 메뉴(⋮) | 상태 아이콘과 작업 메뉴(취소 · 재시작 · 삭제 등 그 상태에서 할 수 있는 동작) |
작업 상태
| 상태 | 뜻 | 할 수 있는 일 |
|---|---|---|
| 대기 · 진행 중 | 서버가 파일을 내려받고 있습니다. 진행 중이면 다운로드 중... 과 진행률이 보입니다. | 취소 |
| 완료 | 가져오기가 끝나 모델 · 데이터셋이 등록되었습니다. | 모델 보기/데이터셋 보기, 기록 삭제 |
| 실패 | 오류로 멈췄습니다. 카드에 오류 메시지가 보입니다. | 재시작, 기록 삭제 |
| 취소됨 | 사용자가 취소했습니다. | 재시작, 기록 삭제 |
따라 하기: 실패한 가져오기 다시 시작하기
1단계: 실패한 작업 보기
상태 카드에서 실패/취소 를 누르세요.
2단계: 오류 확인
다시 받을 작업 카드에서 오류 메시지를 확인합니다(예: 저장소 이름이 틀렸거나 접근 토큰이 필요한 비공개 모델).
3단계: 재시작
원인이 해결됐으면 카드의 메뉴에서 재시작 을 누르세요. "다운로드가 재시작되었습니다." 알림이 뜨고 작업이 진행중 으로 옮겨 갑니다.
4단계: 결과 열기
끝나면 카드의 모델 보기(또는 데이터셋 보기)로 결과를 여세요.
팁 비공개(gated) HuggingFace 모델은 플랫폼에 HuggingFace 토큰이 설정되어 있어야 받을 수 있습니다. 토큰은 운영 관리자가 플랫폼 설정의 Model Registry → HuggingFace 에서 넣습니다.
따라 하기: 끝난 기록 한꺼번에 정리하기
1단계: 작업 고르기
지울 작업 카드의 체크박스를 고르거나 전체 선택 을 누르세요.
2단계: 선택 삭제
위에 나타나는 선택 삭제 를 누르세요. 괄호 안 숫자는 실제로 지울 수 있는 개수입니다.
3단계: 결과 확인
확인하면 "N개 항목이 삭제되었습니다." 알림이 뜹니다.
주의 삭제할 수 있는 것은 완료 · 실패 · 취소된 작업 기록뿐입니다. 진행 중인 작업은 먼저 취소하세요. 기록을 지워도 이미 등록된 모델 · 데이터셋은 지워지지 않습니다.
권한
- 다운로드 메뉴는 플랫폼 운영 권한(IGA
platform:operation의 Operate)이 있는 사람, 즉 운영 관리자에게 보입니다. 권한이 없으면 메뉴가 보이지 않고, 주소로 들어와도 권한 없음 안내가 나옵니다. - 일반 사용자는 자기 가져오기 진행 상황을 모델 레지스트리 · 데이터셋 화면에서 확인합니다.
알아두면 좋은 점
- 다운로드는 서버에서 진행되므로 브라우저를 닫아도 계속됩니다. 완료되면 모델 · 데이터셋 목록에서 확인할 수 있습니다.
- 가져온 파일은 플랫폼 내부 S3 스토리지에 저장되므로, 외부 인터넷이 막힌(에어갭) 환경에서도 이후 학습 · 서빙에 그대로 쓸 수 있습니다.
- 목록은 한 페이지에 10개씩 보이며 아래에서 페이지를 넘깁니다("40개 중 1-10").