학습 카탈로그
학습 마법사의 프레임워크·모델·하이퍼파라미터 선택지를 프레임워크 키마다 DB 에 입력하고 이미지 라벨과 맞추는 방법
필요 권한: 설정ADMIN
새 학습 마법사의 2단계(프레임워크 카드), 3단계(모델), 7단계(하이퍼파라미터) 선택지는 학습 카탈로그가 결정. 카탈로그는 프레임워크 키(학습 런타임 변형의 프레임워크 값, 예: defect-clf)마다 하나. 같은 키를 가진 변형은 모두 같은 카탈로그 사용.
카탈로그를 찾는 순서
| 순서 | 위치 | 입력하는 사람 |
|---|---|---|
| 1 | 테넌트 DB: 이 테넌트의 카탈로그 | 테넌트 관리자 (이 화면) |
| 2 | 공유 DB: 같은 키를 쓰는 모든 테넌트에 적용 | 전역 관리자 (공유 이미지) |
| 3 | 코드: 플랫폼에 내장된 정의 | 플랫폼 배포 |
앞에서 찾으면 뒤는 보지 않음. 테넌트 DB 에 저장하면 그 테넌트에서는 공유 DB 와 코드보다 우선.
내장 프레임워크(YOLO, RF-DETR, Pointcept)는 Dockerfile 과 함께 관리되는 코드가 정본. 이 키들은 DB 에 저장 불가.
카탈로그 상태
학습 런타임 목록의 카탈로그 열에 키마다 상태 표시.
| 배지 | 뜻 | 마법사 |
|---|---|---|
DB · 수동 | DB 에 저장된 카탈로그. 사람이 편집함 | 선택 가능 |
DB · 라벨 반입 | DB 에 저장된 카탈로그. 런타임 이미지의 라벨에서 자동으로 들어옴 | 선택 가능 |
코드 정본 | 내장 프레임워크 | 선택 가능 |
코드 기본값 | DB 에 없어 코드에 내장된 정의로 동작 중 | 선택 가능, 카드에 안내 표시 |
카탈로그 없음 | DB 에도 코드에도 없음 | 선택 불가, 카드에 사유 표시 |
코드 기본값 과 카탈로그 없음 은 입력 필요 상태. 입력 전까지 학습 런타임 화면 위 주황색 배너, 목록의 카탈로그 열, 마법사 2단계 카드에 경고 표시. 코드 기본값은 이후 릴리스에서 제거될 수 있으므로 미리 DB 로 입력 권장.
카탈로그 입력과 편집
- 관리자 콘솔의 학습 런타임 에서 배너의 키 입력 버튼, 또는 변형 행의 카탈로그 아이콘 클릭. 편집 화면 표시.
- 시작점 에서 출발할 본문 선택 후 불러오기. 코드 기본값으로 채우기, 공유 카탈로그 복사, 이미지 라벨에서 가져오기, 다른 키의 카탈로그 복사, 빈 매니페스트 중 선택. 협력사가 전달한
hp_preset.yaml은 hp_preset.yaml 가져오기 로 지금 본문에 합침. 왼쪽에서 YAML 을 편집하면 서버가 바로 검증하고 오류가 있는 행을 빨갛게 표시. 오른쪽 위저드 미리보기에 2·3·7단계 모습 표시. - 오류가 없으면 DB 에 저장 클릭. 확인 창에 함께 바뀌는 변형 수와, 빠지는 모델 키 때문에 다시 실행할 수 없게 되는 실험 수 표시.
본문 형식은 카탈로그 등록 참고.
이미지 라벨과의 관계
런타임 이미지는 자기 카탈로그를 OCI 라벨 io.geo-mlops.catalog.v1 로 포함 가능. 플랫폼 레지스트리에 있는 이미지만 라벨을 읽음(외부 레지스트리 이미지는 이미지 라벨 열에 조회 불가). 이미지 반입이 끝날 때, 레지스트리에 같은 태그로 push 될 때, 변형을 만들거나 수정할 때 라벨을 읽음.
| 상황 | 동작 | 이미지 라벨 열 |
|---|---|---|
| 이 키의 테넌트 카탈로그가 없음 | 라벨로 카탈로그 생성(DB · 라벨 반입) | DB 와 같음 |
카탈로그가 DB · 라벨 반입 | 새 라벨 내용으로 자동 갱신 | DB 와 같음 |
카탈로그가 DB · 수동 | 변경 없음 | 라벨과 다름 |
| 라벨의 키가 변형의 프레임워크와 다름 | 반영하지 않음 | 라벨 키 불일치 |
| 라벨 키가 내장 프레임워크 | 반영하지 않음 | 라벨 오류 |
| 변형의 프레임워크가 제한 없음 | 반영하지 않고 키를 기록 | 키 지정 대기 |
라벨과 다름 인 변형을 목록에서 선택하면 아래 상세에 라벨에서 다시 가져오기 표시. 누르면 라벨 내용으로 카탈로그를 바꾸고 출처가 DB · 라벨 반입 으로 변경(이전 본문은 이력에 남음). 라벨 원문 보기 는 DB 를 바꾸지 않고 레지스트리의 라벨만 표시.
프레임워크가 지정되지 않은 외부 변형
카탈로그는 키에 붙으므로 프레임워크가 제한 없음 인 외부 변형에는 카탈로그가 붙지 않음. 배너와 변형 상세에 이런 변형이 표시되며, 변형 상세의 프레임워크 키 지정(배너에서는 <태그> 키 지정)으로 키를 한 번 지정 가능. 이미지 라벨이 키를 밝혔으면 그 키가 미리 채워짐. 지정하면 라벨을 다시 읽어 반영. 한 번 정한 키는 변경 불가.
새 외부 변형은 변형 추가 창의 학습 프레임워크에서 자체 키 입력 으로 처음부터 키 지정 가능(이미지 변형 참고).
이력과 삭제
- 편집 화면 아래 이력 보기 에 저장·라벨 반입·되돌리기마다 남은 본문 목록 표시. 이 본문으로 되돌리기 는 그 본문으로 새 버전을 저장.
- 테넌트 카탈로그 삭제 는 이 테넌트의 DB 카탈로그와 이력을 삭제. 이후 공유 DB 또는 코드 기본값으로 동작하고, 둘 다 없으면
카탈로그 없음.