Prhub

#27287 docs(cookbook): add Docker install option for Gemma 4

原始 PR 作者 dougyster 合并时间 2026-06-05 03:45 文件变更 1 提交数 2 评论 1 代码增减 +20 / -3

执行摘要

Gemma 4 cookbook 新增 Docker 安装说明

为 Gemma 4 用户提供更便捷的安装方式,避免手动从源码构建;同时修复过时的 transformers 依赖锁定。

可直接合并。建议后续关注 Docker 镜像的更新频率,以及是否需要同步更新其他 cookbook 的 Docker 安装说明。

讨论亮点

审核人 kpham-sgl 感谢贡献并请求删除仍残留的 'pip install transformers commit' 行。PR 作者在 commit 中已处理。无其他讨论。

实现拆解

  1. 新增 Docker 安装小节:在 docs_new/cookbook/autoregressive/Google/Gemma4.mdx 的 §2 安装章节中新增一个子章节,列出三个预构建镜像标签及对应的 CUDA 版本,并提供一个 docker run 命令示例,与已有的 pip-from-source 指令并列。
  2. 删除过时的 transformers pin:移除原先 pip install 'git+...transformers.git@1423d22...' 这一行,因为该 pin 已经过时,改用 SGLang 自身的依赖解析来安装 transformers。
  3. 文档结构维持:其余内容未变,仅调整了安装章节的编排。
文件 模块 状态 重要度
docs_new/cookbook/autoregressive/Google/Gemma4.mdx 文档 modified 2.86

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

删除过时的 transformers pin 正确性

审核者 kpham-sgl 要求删除残留的 pip install transformers commit 行,因为该 pin 已过时。

结论:PR 作者在第二个 commit 中已删除该行,问题已解决。 · 已解决

风险与影响

纯文档变更,无代码路径修改,风险极低。但需确保 Docker 镜像标签的生命周期(如旧版本不再维护)不会误导用户使用已过时的镜像。

影响范围限于 Gemma 4 cookbook 的读者。对已有通过 pip 安装的用户无影响;对希望使用 Docker 的用户提供了零配置的启动方式。

纯文档变更 依赖外部 Docker 镜像更新

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论