노트북에서 MLflow 사용 (토큰 발급) | MLOps Central Platform 매뉴얼

플랫폼에 MLflow 내장. 토큰을 발급하면 개인 노트북(Jupyter 등)에서 실행한 실험도 플랫폼의 실험 화면에 표시. 토큰은 발급한 테넌트에 귀속되므로 기록도 그 테넌트에만 저장.

오른쪽 위 계정 메뉴 → 계정 설정의 MLflow 토큰 관리(또는 관리자 콘솔 → MLflow 토큰)로 이동. ① 이름(예: my-notebook) ② 만료 일수(기본 90일, 무기한도 가능) 지정 후 ③ 발급 클릭.
MLflow 토큰: ① 이름 ② 만료 일수 ③ 발급

토큰은 이때 한 번만 표시. 명령 복사로 아래 두 줄을 복사해 안전한 곳에 보관.

export MLFLOW_TRACKING_URI=https://mlops.example.com/mlflow
export MLFLOW_TRACKING_TOKEN=<your-secret>

같은 셸에서 노트북을 실행하거나 노트북 첫 셀에서 환경 변수를 설정한 뒤 평소처럼 MLflow 사용.

import os, mlflow
os.environ["MLFLOW_TRACKING_URI"] = "https://mlops.example.com/mlflow"
os.environ["MLFLOW_TRACKING_TOKEN"] = "<your-secret>"

mlflow.set_experiment("helmet-notebook")
with mlflow.start_run(run_name="baseline"):
    mlflow.log_param("imgsz", 640)
    mlflow.log_metric("mAP50", 0.81)

플랫폼의 실험 화면에 helmet-notebook 실험과 Run 표시. 완료된 Run 은 Run 상세의 모델 등록으로 레지스트리 등록도 가능.

MLflow 클라이언트는 MLFLOW_TRACKING_TOKEN 을 Authorization: Bearer 헤더로 전송. 테넌트는 토큰으로 결정되므로 별도 지정 불필요.
토큰 목록에서 활성·만료됨·회수됨 상태를 확인하고, 더 이상 사용하지 않는 토큰은 회수. 테넌트 관리자는 테넌트의 모든 토큰 조회 가능.
발급한 사람의 역할이 변경되거나 테넌트에서 제외되어도 토큰은 회수하거나 만료될 때까지 유효. 멤버가 제외되면 그 멤버의 토큰 회수.
토큰은 비밀번호처럼 관리. 노트북 파일에 포함해 공유하지 말고 환경 변수나 비밀 저장소에 보관.

모델 로깅 규칙, 레지스트리 등록 방법, 컨테이너 레지스트리 토큰 등 자세한 연동은 연동 장 참고.