모델 레지스트리 | MLOps Central Platform 매뉴얼

학습 결과를 이름이 지정된 모델의 버전으로 관리. 버전마다 스테이지(검증 중, 운영 중 등) 지정. 운영(Production) 승격은 항상 승인을 거침. 서빙·현장 배포용 컨테이너 이미지도 버전 화면에서 빌드.

모델 목록

모델 레지스트리: ① Production 유무 필터 ② 모델 검색 ③ 스테이지별 버전 ④ 모델(상세로)

번호	영역	설명
①	Production 필터	전체 모델 · Production 있음 · Production 없음.
②	모델 검색	모델 이름으로 검색.
③	스테이지 열	스테이지별 버전. 없으면 "—".
④	모델	클릭 시 모델 상세로 이동. 등록 모델 태그 `geo.safety_critical` 이 `true` 인 모델에는 안전 필수 배지 표시.

MLflow 가 연결되지 않은 환경에서는 목록 대신 "MLflow가 설정되지 않았습니다" 안내 표시.

모델 상세

번호	영역	설명
①	머리 동작	드리프트·모니터링 바로가기, 모델 삭제(`model_register`). Production 버전이 있으면 삭제 버튼 비활성화. 서빙 중인 엔드포인트가 있어도 서버가 거부. 삭제 대상은 레지스트리 항목과 코멘트, 각 버전을 만든 Run 의 아티팩트는 유지.
②	프로덕션 승격	승격 요청 대화상자(`production_promote`, APPROVER·ADMIN).
③	버전 히스토리	버전·스테이지·상태·만든 Run·생성. 줄 클릭 시 버전 상세로 이동.
④	아카이브	버전을 Archived 로 변경(`staging_promote`, Production 버전은 `production_promote`). 이미 Archived 인 버전에는 없음. 오른쪽 휴지통은 버전 삭제(`model_register`). Production 버전의 휴지통은 흐리게 표시, 먼저 아카이브해야 삭제 가능.
⑤	버전 비교	두 버전의 Run 지표를 나란히 비교.
⑥	코멘트	버전별 메모. 작성은 `develop`.

안전 필수 모델은 제목 옆에 안전 필수 · 승인 2건 배지 표시. 승인 기능이 활성화되어 있고 대기 중인 승격 요청이 있으면 제목 아래에 "승인 대기 중: v3 (0/1)" 형식의 링크 표시.

모델 버전 상세

번호	영역	설명
①	버전 정보	버전·스테이지·상태·Run·생성. 모델 다운로드(단일 파일은 그대로, 모델 폴더는 zip), 아카이브, 버전 삭제(`model_register`, Production 버전이면 거부됨).
②	컨테이너 이미지	이 버전의 서빙 이미지. 이미지 빌드(`deploy`)로 생성, 이미 있으면 다시 빌드 로 변경. 빌드 중이거나 빌드할 수 없는 환경이면 버튼 비활성화. 서빙 빌더 에서 빌더 변형 선택 가능, 선택하지 않으면(자동) 테넌트 기본 빌더 사용. 준비되면 레지스트리 이미지 링크와 빌더 변형 표시. 빌드한 이미지는 API 서비스와 현장 배포에 사용.
③	코멘트	모델 상세의 코멘트와 동일.

이 버전에 대기 중인 승격 요청이 있으면 ① 아래 승인 카드에 승인 수(예: 0/1), 요청자, 요청 보기 링크 표시. 마지막 요청이 반려됐으면 반려 사유 표시.

빌드 전 모델 점검에서 문제가 있으면 ② 에 경고 표시(예: 시그니처 없이 기록된 PyTorch 모델은 빌드는 되지만 첫 추론에서 실패). 빌드할 수 없는 환경이면 ② 에 노란 안내 표시. "서빙 빌더 변형이 없습니다" 면 시스템 관리자에게 공유 이미지를 요청하거나 테넌트 관리자가 서빙 빌더 화면에서 전용 변형을 만들어 게시. "빌더 이미지 … 가 레지스트리에 없습니다" 면 서빙 빌더 화면에서 게시, 공유 빌더가 게시되지 않았으면 시스템 관리자가 공유 이미지 화면에서 게시. 서빙 파이프라인이 비활성화된 환경이면 점선 안내 표시, 빌드 불가. Pointcept 모델의 서빙 이미지는 학습 런타임 이미지 위에 빌드. 학습 때 사용한 이미지 기록이 없고 테넌트에 Pointcept 기본 학습 런타임 변형도 없으면 빌드 거부. 이때는 학습 런타임 화면에서 Pointcept 변형을 게시하고 기본으로 지정한 뒤 다시 빌드. 빌드 중에는 경과 시간 표시, 로그 보기 로 로그 실시간 확인. 이 화면이 열려 있으면 빌드 종료 시 알림 표시. 실패하면 오류 첫 줄 표시, 빌드 로그 로 원인 확인.

주요 작업

프로덕션 승격 요청

모델 상세에서 프로덕션 승격 클릭.
승격 버전(Production 이 아닌 버전) 선택, 사유(필수) 입력. 롤백 조건, 범위 는 승인자의 판단 근거로 기록. 승격 요청 클릭.
프로덕션 승격 요청: 승인 화면으로 전달되며, 필요한 승인 수가 충족되면 Production 으로 전환
요청은 승인 화면으로 전달. 필요한 승인 수가 충족되면 그 버전이 Production 이 되고, 기존 Production 버전은 Archived 로 변경.

승격이 끝나도 배포는 자동으로 시작되지 않음. 서빙·현장 배포는 API 서비스와 배포에서 별도 진행.

아카이브

버전 줄의 아카이브 아이콘 클릭 후 확인하면 그 버전이 Archived 로 변경. 레지스트리 라벨만 변경, 삭제되는 항목 없음.

상태·배지

스테이지	뜻	진입 경로
None	미지정	플랫폼을 거치지 않고 MLflow 로 직접 등록한 버전.
Staging	검증 중	Run 에서 모델 등록하거나 학습에서 자동 등록 시 이 스테이지.
Production	운영 중	승격 요청 → 승인. 모델마다 하나.
Archived	보관	아카이브하거나, 새 버전이 Production 이 되면서 이전 버전이 전환됨.

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

모델 목록#

모델 상세#

모델 버전 상세#

주요 작업#

프로덕션 승격 요청#

아카이브#

상태·배지#