docker/model-runner

Docker Model Runner 镜像文档

1. 镜像概述和主要用途

Docker Model Runner 镜像旨在为 Docker CE 环境提供 Model Runner 功能支持。这些镜像并非为终端用户直接使用而设计，而是作为 Docker Model 功能的底层组件，由 Docker Model CLI 插件管理和调用。用户需通过特定 CLI 命令触发镜像的拉取与运行，以实现 Docker CE 中的模型运行相关功能。

2. 核心功能和特性

• Docker Model Runner 支持：提供运行模型所需的基础环境，确保 Docker CE 可集成并执行模型相关任务。
• CLI 插件协同：与 Docker Model CLI 插件深度集成，通过插件命令自动完成镜像的拉取、配置与启动，简化用户操作流程。
• 多变体支持：提供 cuda 等硬件加速变体（基于 nvidia/cuda 基础镜像），满足 GPU 环境下的模型运行需求（具体变体需参考官方仓库说明）。

3. 使用场景和适用范围

• 适用环境：仅适用于 Docker CE（Community Edition）环境，不支持其他 Docker 发行版（如 Docker EE）。
• 用户对象：供 Docker Model CLI 插件内部调用，不建议终端用户直接操作（如手动 docker run）。
• 核心场景：支持通过 Docker Model 功能运行机器学习模型、AI 任务等场景，作为模型运行时的基础设施组件。

4. 使用方法和配置说明

4.1 前置条件

• 已安装 Docker CE（版本需满足 Docker Model 功能要求，具体版本参考 https://docs.docker.com/model-runner/%EF%BC%89%E3%80%82
• 已安装 Docker Model CLI 插件（安装方法见 https://docs.docker.com/model-runner/%EF%BC%89%E3%80%82

4.2 基本使用流程

通过 Docker Model CLI 插件自动管理镜像，无需手动拉取或运行：

1. 安装 Docker Model CLI 插件（具体步骤参考 https://docs.docker.com/model-runner/%EF%BC%89%E3%80%82
2. 执行以下命令触发镜像拉取与配置：

   bash
   docker model install-runner
   

   插件会根据当前环境自动选择合适的镜像变体（如 CPU 或 GPU 版本），并完成启动配置。

4.3 配置说明

当前镜像无需用户手动配置参数或环境变量，所有配置由 Docker Model CLI 插件根据系统环境自动处理。如需自定义配置（如镜像版本、资源限制等），请参考插件文档或 https://github.com/docker/model-runner 说明。

5. 许可证信息

• 基础镜像许可：镜像源码及依赖来自 https://github.com/docker/model-runner%EF%BC%8C%E8%AE%B8%E5%8F%AF%E8%AF%81%E4%BF%A1%E6%81%AF%E8%AF%A6%E8%A7%81%E8%AF%A5%E4%BB%93%E5%BA%93%E5%8F%8A%E4%BE%9D%E8%B5%96%E9%A1%B9%E7%9A%84 LICENSE 文件。
• CUDA 变体许可：cuda 硬件加速变体基于 nvidia/cuda 基础镜像构建，需遵守 NVIDIA CUDA 相关许可协议，详情见 https://hub.docker.com/r/nvidia/cuda%E3%80%82