모델 레지스트리 | Geo-MLOps 매뉴얼

학습 결과를 이름 붙은 모델의 버전으로 관리하는 화면입니다. 버전마다 스테이지(검증 중인지, 운영 중인지)가 붙고, 운영(Production)으로 올리는 것은 항상 승인을 거칩니다. 서빙·현장 배포에 쓸 컨테이너 이미지도 버전 화면에서 빌드합니다.

모델 목록

번호	영역	설명
①	Production 필터	전체 모델 · Production 있음 · Production 없음.
②	모델 검색	모델 이름으로 찾습니다.
③	스테이지 열	스테이지마다 그 스테이지에 있는 버전. 없으면 "—".
④	모델	누르면 모델 상세로 갑니다. 안전 필수로 표시된 모델에는 안전 필수 배지가 붙습니다.

번호	영역	설명
①	머리 동작	드리프트·모니터링 바로가기, 모델 삭제(`model_register`). Production 버전이 있으면 삭제가 막힙니다.
②	프로덕션 승격	승격 요청 대화상자(`production_promote`, APPROVER·ADMIN).
③	버전 히스토리	버전·스테이지·상태·만든 Run·생성. 줄을 누르면 버전 상세로 갑니다.
④	아카이브	버전을 Archived 로 내립니다(`staging_promote`, Production 버전은 `production_promote`). 오른쪽 휴지통은 버전 삭제(`model_register`)입니다.
⑤	버전 비교	두 버전을 골라 Run 지표를 나란히 봅니다.
⑥	코멘트	버전별 메모. 쓰기는 `develop`.

승인 기능이 켜져 있고 대기 중인 승격 요청이 있으면 제목 아래에 "승인 대기 중: v3 (0/1)" 처럼 링크가 붙습니다.

번호	영역	설명
①	버전 정보	버전·스테이지·상태·Run·생성. 모델 다운로드, 아카이브, 버전 삭제.
②	컨테이너 이미지	이 버전의 서빙 이미지. 이미지 빌드(`deploy`)로 만들고, 이미 있으면 다시 빌드 가 됩니다. 빌드한 이미지는 API 서비스와 현장 배포에서 다시 씁니다.
③	코멘트	모델 상세의 코멘트와 같습니다.

빌드할 수 없는 환경이면 ② 에 노란 안내가 붙습니다. 예를 들어 "서빙 빌더 변형이 없습니다" 가 보이면 테넌트 관리자가 서빙 빌더를 게시해야 합니다. 빌드 중에는 로그 보기 로 빌드 로그를 실시간으로 보고, 실패하면 빌드 로그 로 원인을 확인합니다.

모델 상세에서 프로덕션 승격 을 누릅니다.
승격 버전 을 고르고 사유(필수)를 적습니다. 롤백 조건, 범위 는 승인자가 판단할 근거로 남깁니다. 승격 요청 을 누릅니다.
프로덕션 승격 요청: 승인 화면으로 전달되고, 승인이 모이면 Production 이 된다
요청은 승인 화면으로 갑니다. 필요한 승인이 모이면 그 버전이 Production 이 되고, 기존 Production 버전은 Archived 로 내려갑니다.

승격이 끝나도 배포는 자동으로 시작되지 않습니다. 서빙·현장 배포는 API 서비스와 배포에서 따로 합니다.

버전 줄의 아카이브 아이콘을 누르고 확인하면 그 버전이 Archived 로 내려갑니다. 레지스트리 라벨만 바뀌고 지워지는 것은 없습니다.

스테이지	뜻	들어가는 길
None	미지정	없음
Staging	검증 중	Run 에서 모델 등록하거나 학습에서 자동 등록하면 여기로 들어갑니다.
Production	운영 중	승격 요청 → 승인. 모델마다 하나.
Archived	보관	아카이브하거나, 새 버전이 Production 이 되면서 밀려남.

이미지 빌드 상태: 빌드 중(BUILDING) · 준비됨(READY) · 실패(FAILED).