사용 가이드
데이터셋부터 현장 배포까지, 워크스페이스에서 모델을 만들고 운영하는 방법
이 장은 워크스페이스에서 일하는 사람을 위한 안내입니다. 데이터를 올리고, 모델을 학습하고, 결과를 비교해 좋은 모델을 골라, 승인을 거쳐 서빙하고 현장 장비(엣지)로 내보낸 뒤, 운영 중에 성능이 떨어지면 다시 학습하는 한 바퀴를 다룹니다.
플랫폼 설치는 설치, 멤버·토큰·학습 런타임 같은 관리 화면은 관리, 외부 학습 컨테이너·MLflow 직접 연동은 연동을 보세요.
이 장을 읽는 방법
| 무엇 | 언제 읽나 | 어디 |
|---|---|---|
| 튜토리얼: 첫 모델을 현장에 내보내기 | 처음 한 번, 순서대로 따라 할 때 (약 30분) | 튜토리얼 |
| 화면 레퍼런스 | 특정 화면의 버튼·칸이 무엇인지 찾을 때 | 이 장의 화면별 페이지 |
| How-to | 자주 하는 일 하나를 빨리 끝내고 싶을 때 | How-to |
워크스페이스 메뉴
로그인하면 왼쪽 사이드바에 워크스페이스 메뉴가 보입니다. 테넌트에서 꺼 둔 기능과 내 역할로 쓸 수 없는 메뉴는 보이지 않습니다.
| 메뉴 | 하는 일 | 흐름 속 단계 |
|---|---|---|
| 대시보드 | 핵심 지표(KPI)·최근 경보·모델 상태·GPU 슬롯·Edge Fleet 요약 | 전체 |
| 실험 | MLflow 실험과 Run 목록, Run 비교, Run 을 모델로 등록 | ③ 실험 |
| 학습 | 새 학습(11단계 마법사), 학습 실행 목록·상세, 사전학습 가중치 | ② 학습 |
| 모델 레지스트리 | 모델 버전과 스테이지(Staging·Production·Archived), 프로덕션 승격 요청, 서빙 이미지 빌드 | ④ 레지스트리 |
| 컨테이너 레지스트리 | 플랫폼 내장 레지스트리의 이미지 둘러보기·반입 | 보조 |
| 파이프라인 | 파이프라인 실행 이력 | 보조 |
| 배포 | 모델 버전을 엣지 장비에 내보내기, 롤백 | ⑦ 배포 |
| API 서비스 | 서빙 엔드포인트 만들기, 추론 콘솔로 시험 | ⑥ 서빙 |
| 모니터링 | 운영 KPI와 추세 | ⑨ 모니터링 |
| 경보 | 활성 경보 처리, 룰·채널·음소거 | ⑨ 모니터링 |
| 승인 | 프로덕션 승격 요청을 승인·반려 | ⑤ 승인 |
| 데이터셋 | 데이터셋 만들기, 파일 올리기, 외부 소스 동기화 | ① 데이터셋 |
| Edge Fleet | 현장 장비 상태·명령·정책 | ⑧ 엣지 |
| 드리프트 | 입력 데이터 분포 변화(PSI·KS) 추이, 재학습 | ⑩ 드리프트 → 재학습 |
오른쪽 위에는 테넌트 선택(예: DEMO)과 알림함 종, 계정 메뉴가 있습니다. 관리 권한이 있으면 사이드바 아래에 관리자 콘솔도 보입니다.
전체 흐름
모델 하나는 아래 순서로 한 바퀴를 돕니다. 드리프트가 감지되면 다시 ② 학습으로 돌아갑니다.
① 데이터셋 ──▶ ② 학습 ──▶ ③ 실험(Run 비교) ──▶ ④ 모델 레지스트리 (Staging)
▲ │ 프로덕션 승격 요청
│ ▼
⑩ 드리프트 ─┘ ⑤ 승인 ──▶ Production
▲ "이 모델 다시 학습하기" │
│ ▼
⑨ 모니터링·경보 ◀── ⑧ 엣지 장비 ◀── ⑦ 배포 ◀── ⑥ 서빙 이미지 빌드 · API 서비스| 단계 | 메뉴 | 필요한 역할 | 결과물 |
|---|---|---|---|
| ① 데이터셋 만들기·파일 올리기 | 데이터셋 | 개발자 이상 | 확정(FROZEN)된 데이터셋과 파일 목록 |
| ② 학습 | 학습 → 새 학습 | 개발자 이상 | 학습 실행 한 건 = MLflow Run 한 개 |
| ③ Run 비교 | 실험 | 누구나(보기) | 고른 Run |
| ④ 모델 등록 | 실험 → Run → 모델 등록 | 개발자 이상 | 모델 버전 (Staging) |
| ⑤ 프로덕션 승격 요청 → 승인 | 모델 레지스트리 → 승인 | 승인자·관리자 | Production 버전 |
| ⑥ 서빙 이미지 빌드·API 서비스 | 모델 레지스트리 → API 서비스 | 운영자·관리자 | 컨테이너 이미지, 추론 엔드포인트 |
| ⑦~⑧ 배포·엣지 장비 | 배포 | 운영자·관리자 | 장비에서 도는 모델 |
| ⑨~⑩ 모니터링·드리프트 | 모니터링·경보·드리프트 | 누구나(보기) | 재학습 판단 |
역할은 테넌트 관리자가 멤버마다 정합니다. 보기(viewer)·개발자(developer)·운영자(operator)·승인자(approver)·관리자(admin) 다섯 가지이며, 권한이 없는 버튼은 화면에서 숨겨지고 서버도 거절합니다.