Prhub

#26731 [NPU] Update documentation for software version upgrades

原始 PR 作者 OrangeRedeng 合并时间 2026-06-06 20:06 文件变更 6 提交数 4 评论 2 代码增减 +28 / -25

documentation npu infra ci

执行摘要

更新 NPU 文档与 CI/Docker 配置以支持软件版本升级

随着 Ascend 驱动栈和库的更新，需要将 NPU 软件版本升级以保持兼容性并利用最新优化。本 PR 跟随 #26466 的变化，更新文档和配置文件以反映新版本要求，确保用户使用 SGLang 时安装正确的 NPU 依赖。

该 PR 属于常规文档和配置更新，无需要重点关注的技术决策。NPU 相关开发者和用户可阅读了解最新版本要求。

讨论亮点

reviewer ping1jing2 直接 approve，无额外讨论。代码和配置改动直观，未产生设计争议。

实现拆解

  1. 更新系统要求文档：在 ascend_npu.mdx 中更新 HDK、CANN、PyTorch Adapter、MemFabric、Triton、SGLang NPU Kernel、MemFabric-zbal 的版本号和下载链接。
  2. 更新快速启动文档：在 ascend_npu_quick_start.mdx 中更新每日构建镜像标签从 cann8.5.0 改为 cann9.0.0，同时更新稳定版标签。
  3. 更新最佳实践文档：在 ascend_npu_best_practice.mdx 中删除两处指向 /usr/local/Ascend/8.5.0/compiler/bishengir/bin 的 PATH 导出。
  4. 更新 Dockerfile：将 npu.Dockerfile 中的默认 CANN 构建参数从 8.5.0 改为 9.0.0。
  5. 更新 CI 工作流：将 full-test-npu.yml 和 nightly-test-npu.yml 中使用的 Docker 镜像默认标签从 cann:8.5.0-a3 改为 cann:9.0.0-a3。
文件 模块 状态 重要度
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu.mdx 文档 modified 3.99
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_quick_start.mdx 文档 modified 3.09
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_best_practice.mdx 文档 modified 2.14
docker/npu.Dockerfile Docker 配置 modified 2.78
.github/workflows/full-test-npu.yml CI 配置 modified 2.95
.github/workflows/nightly-test-npu.yml CI 配置 modified 2.95

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

评论区精华

无讨论 other

reviewer ping1jing2 直接批准，未产生讨论线程。

结论：无需处理。 · 已解决

风险与影响

主要风险来自依赖版本升级可能引入兼容性问题。CANN 9.0.0 是主版本升级，可能与旧设备或公开协议不兼容。但该 PR 仅更新文档和 CI 配置，实际兼容性验证需依赖后续测试。其他变更均为文本替换，风险较低。

用户需按照更新后的文档安装最新版本依赖（如 CANN 9.0.0、PyTorch Adapter 26.0.0 等），否则可能遇到版本不匹配错误。CI 流水线将使用新镜像运行测试，确保测试环境与文档一致。团队维护者需确保镜像仓库中存在新版本镜像。

依赖版本升级

关联 Issue

未识别关联 Issue

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

完整报告

Markdown PDF

参与讨论