Prhub

#7140 [docker] chore: Rocm714 doc update

原始 PR 作者 mingjielu 合并时间 2026-07-24 23:40 文件变更 6 提交数 3 评论 4 代码增减 +408 / -1048

执行摘要

更新 ROCm 7.14 Docker 构建文档与示例

随着 ROCm 7.14 的发布,需要更新 Docker 构建文档以使用最新的基镜像和软件版本,并提供可复现的 Dockerfile 示例。同时清理已过时的旧文档,降低用户混淆。

值得关注的设计决策是将主 Dockerfile 切换为基于预构建基镜像,这显著降低了维护成本。建议精读 Dockerfile.rocm 和 new Dockerfile.rocm702 的结构差异以理解下一步构建策略。对于 AMD 用户,应优先使用更新后的 amd_quick_start.rst 作为起点。

讨论亮点

在 Review 中,wuxibin89 询问是否可以删除 amd_build_dockerfile_page.rst。mingjielu 确认该文档是旧版(ROCm 6.3)构建指南,现已由 amd_quick_start.rst 替代,并已更新 README 和索引指向新文档。双方达成一致后文件被删除。结论:删除旧文档,保留历史 Dockerfile 作为参考。

实现拆解

  1. Dockerfile 架构调整:将主 Dockerfile.rocm 重构为基于预构建的 rocm/primus:v26.4 基镜像,避免从源头编译,简化构建流程并提高可复现性。新增 Dockerfile.rocm702 作为历史版本(ROCm 7.0.2)的参考,保留原有的从 ubuntu:22.04 开始的多阶段构建。
  2. 知识库文档迁移:删除旧的、内容庞大的 amd_build_dockerfile_page.rst(-796 行),其内容已过时且覆盖了 ROCm 6.x 和手动编译细节;将 amd_quick_start.rst 更新为当前推荐的快速入门指南,更新软件版本号(ROCm 7.14、PyTorch 2.12、vLLM 0.22.1rc1、SGLang 0.5.15 等),并更新硬件支持列表(MI350X 加入),同时增加 SGLang 为完全支持。
  3. 辅助文档同步:更新 docker/rocm/README.md 以反映新的构建基镜像和版本清单;修改 docs/amd_tutorial/index.rst 移除对已删除页面的引用,并将入口统一指向 amd_quick_start.rst。
文件 模块 状态 重要度
docker/rocm/Dockerfile.rocm Docker 镜像 modified 5.46
docker/rocm/Dockerfile.rocm702 Docker 镜像 added 5.19
docs/amd_tutorial/amd_quick_start.rst AMD 教程 modified 3.53
docs/amd_tutorial/amd_build_dockerfile_page.rst AMD 教程 removed 4.4
docker/rocm/README.md Docker 镜像 modified 2.67
docs/amd_tutorial/index.rst AMD 教程 modified 1.18

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

评论区精华

删除旧文档 amd_build_dockerfile_page.rst 设计

wuxibin89 询问是否可以删除该文件,mingjielu 确认是旧文档并已更新入口。

结论:一致同意删除,旧文档已被新文档替代。 · 已解决

风险与影响

由于 Dockerfile.rocm 的构建方式从自适应编译改为基于预编译基镜像,依赖链发生改变(不再需要从头编译 Flash Attention、TE 等),可能对希望自定义 GPU 架构或修改底层组件的用户造成影响。文档删除可能使依赖旧教程的用户暂时找不到信息,但已有明确重定向。无代码执行风险。

核心影响是对 AMD GPU 用户(MI300X/MI325X/MI350X/MI355X):构建时间大幅缩短,但失去了一些可配置性;文档结构更清晰,入门门槛降低。对其他平台用户无影响。

构建模式切换 文档重构

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论