执行摘要
- 一句话:Gemma 4 cookbook 新增 Docker 安装说明
- 推荐动作:可直接合并。建议后续关注 Docker 镜像的更新频率,以及是否需要同步更新其他 cookbook 的 Docker 安装说明。
功能与动机
为 Gemma 4 用户提供更便捷的安装方式,避免手动从源码构建;同时修复过时的 transformers 依赖锁定。
实现拆解
- 新增 Docker 安装小节:在
docs_new/cookbook/autoregressive/Google/Gemma4.mdx 的 §2 安装章节中新增一个子章节,列出三个预构建镜像标签及对应的 CUDA 版本,并提供一个 docker run 命令示例,与已有的 pip-from-source 指令并列。
- 删除过时的 transformers pin:移除原先
pip install 'git+...transformers.git@1423d22...' 这一行,因为该 pin 已经过时,改用 SGLang 自身的依赖解析来安装 transformers。
- 文档结构维持:其余内容未变,仅调整了安装章节的编排。
关键文件:
docs_new/cookbook/autoregressive/Google/Gemma4.mdx(模块 文档;类别 other;类型 documentation): 唯一变更文件,新增 Docker 安装小节并删除过时的 transformers commit pin。
关键符号:未识别
评论区精华
审核人 kpham-sgl 感谢贡献并请求删除仍残留的 'pip install transformers commit' 行。PR 作者在 commit 中已处理。无其他讨论。
- 删除过时的 transformers pin (correctness): PR 作者在第二个 commit 中已删除该行,问题已解决。
风险与影响
- 风险:纯文档变更,无代码路径修改,风险极低。但需确保 Docker 镜像标签的生命周期(如旧版本不再维护)不会误导用户使用已过时的镜像。
- 影响:影响范围限于 Gemma 4 cookbook 的读者。对已有通过 pip 安装的用户无影响;对希望使用 Docker 的用户提供了零配置的启动方式。
- 风险标记:纯文档变更, 依赖外部 Docker 镜像更新
关联脉络
- PR #27167 Gemma 4 support: 本 PR 引用的 Gemma 4 支持 PR,是本次 Docker 安装功能的基础。
参与讨论