docker model package

docker model package

docker model package 명령은 모델을 Docker Model OCI 아티팩트로 패키징합니다.

출처: 문서

본문

모델을 Docker Model OCI 아티팩트로 묶는 명령어예요. 모델 소스는 다음 중 하나여야 해요:

  • --gguf — GGUF 파일 (단일 파일 또는 분할 모델의 첫 번째 샤드)
  • --safetensors-dir.safetensors 파일과 구성 파일이 담긴 디렉토리
  • --dduf.dduf (Diffusers Unified Format) 아카이브
  • --from — 기존에 패키징된 모델 참조

기본적으로 패키징된 아티팩트는 로컬 Model Runner 콘텐츠 저장소에 로드돼요. 대신 레지스트리에 게시하려면 --push를 사용해요.

MODEL은 대상 모델 참조를 지정해요 (예: myorg/llama3:8b). --push를 사용할 땐 MODEL이 레지스트리로 한정된 참조여야 해요.

패키징 동작:

GGUF--gguf.gguf 파일을 가리켜야 해요. 분할 모델이라면 첫 번째 샤드를 가리켜요. 모든 샤드는 같은 디렉토리에 있어야 하고, 색인된 명명 규칙(예: model-00001-of-00015.gguf)을 따라야 해요. 모든 샤드가 자동으로 발견되어 함께 패키징돼요.

Safetensors--safetensors-dir.safetensors 파일과 필수 구성 파일(모델 config, 토크나이저 파일 등)이 담긴 디렉토리를 가리켜야 해요. 디렉토리 아래의 모든 파일(중첩 하위 디렉토리 포함)이 자동으로 발견돼요. 각 파일은 별도의 OCI 레이어로 패키징돼요.

DDUF--dduf.dduf 아카이브 파일을 가리켜야 해요.

재패키징--from은 기존 모델을 다시 패키징해요. --context-size 같은 일부 속성을 덮어써서 원본 모델의 변형을 만들 수 있어요.

멀티모달 모델--mmproj를 사용해 멀티모달 프로젝터 파일을 포함해요.

옵션 (Options)

옵션 기본값 설명
--chat-template 채팅 템플릿 파일의 절대 경로 (Jinja 형식이어야 함)
--context-size 토큰 단위 컨텍스트 크기
--dduf DDUF 아카이브 파일의 절대 경로 (Diffusers Unified Format)
--format docker 출력 아티팩트 형식: "docker" (기본) 또는 "cncf" (CNCF ModelPack 규격)
--from 재패키징할 기존 모델 참조
--gguf gguf 파일의 절대 경로
-l, --license 라이선스 파일의 절대 경로
--mmproj 멀티모달 프로젝터 파일의 절대 경로
--push 레지스트리로 push (설정하지 않으면 모델이 Model Runner 콘텐츠 저장소에 로드됨)
--safetensors-dir safetensors 파일과 config를 담은 디렉토리의 절대 경로