Prhub

#6291 [doc] chore: update vllm and vllm ascend from 0.13.0 to 0.18.0 in docs and dockerfile

原始 PR 作者 wangshuyang31 合并时间 2026-05-11 14:19 文件变更 3 提交数 1 评论 3 代码增减 +13 / -8

执行摘要

更新 vllm 和 vllm-ascend 版本至 v0.18.0

为了使用 vllm 和 vllm-ascend 的新版本特性或修复,需要更新 Ascend 相关的 Dockerfile 和文档中的版本号。

该 PR 不应直接合并。建议作者至少:

  1. 恢复 torch_npu==2.8.0 的安装,或确认新版本 vllm/vllm-ascend 已不再需要显式指定。
  2. 移除或限制 GIT_SSL_NO_VERIFY 的使用。
  3. 补充适配新版本 vllm 的代码变更(如果有)。
讨论亮点

gemini-code-assist[bot] 提出了两个关键问题:

  • 在 Dockerfile 中移除 torch_npu==2.8.0 会导致回归,因为 torch_npu 是 Ascend NPU 的关键依赖,且文档中仍要求 torch_npu == 2.8.0。
  • 设置 GIT_SSL_NO_VERIFY=true 存在安全风险,会使构建过程暴露于中间人攻击。

审核者 wucong25 直接批准了 PR,未对这些评论进行回复或解决。

实现拆解

  1. 修改 docker/ascend/Dockerfile.ascend_8.5.0_a3:将 git clone 的 vllm 分支从 v0.13.0 改为 v0.18.0,vllm-ascend 分支从 releases/v0.13.0 改为 releases/v0.18.0;添加了华为云 pip 镜像配置和 GIT_SSL_NO_VERIFY=true 环境变量;移除了 pip install mbridge 命令中的 torch_npu==2.8.0 部分。
  2. 修改 docker/ascend/Dockerfile.ascend_8.5.0_a2:版本号更新逻辑与 a3 相同,同样移除了 torch_npu==2.8.0 的显式安装。
  3. 修改 docs/ascend_tutorial/quick_start/ascend_quick_start.rst:将文档中的 git clone 命令中的 vllm 分支和 vllm-ascend 分支版本号更新为 v0.18.0。
文件 模块 状态 重要度
docker/ascend/Dockerfile.ascend_8.5.0_a3 Docker modified 3.66
docker/ascend/Dockerfile.ascend_8.5.0_a2 Docker modified 3.08
docs/ascend_tutorial/quick_start/ascend_quick_start.rst 文档 modified 1.9

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

评论区精华

移除 torch_npu 依赖导致回归 正确性

gemini-code-assist[bot] 指出移除 `torch_npu==2.8.0` 会导致 NPU 环境崩溃,因为该依赖未在其他地方声明,且文档仍要求该版本。

结论:未解决,PR 直接合并,风险残留。 · unresolved

禁用 Git SSL 验证的安全风险 安全

gemini-code-assist[bot] 指出 `GIT_SSL_NO_VERIFY=true` 会使 git clone 操作易受中间人攻击,建议使用 CA 证书或安全代理。

结论:未解决,PR 直接合并,安全风险残留。 · unresolved

风险与影响

  1. 回归风险:移除 torch_npu==2.8.0 显式安装会导致 NPU 运行时环境缺失关键依赖,可能使所有 Ascend NPU 上的训练/推理任务失败。
  2. 安全风险:GIT_SSL_NO_VERIFY=true 使 git clone 操作跳过 SSL 证书验证,易受中间人攻击。
  3. 兼容性风险:vllm 从 0.13.0 跳升到 0.18.0,可能存在 API 或行为不兼容,但 PR 未更新任何 Python 代码来适配新版本。

影响范围:仅影响 Ascend NPU 用户,具体为使用 Dockerfile.ascend_8.5.0_a3 和 Dockerfile.ascend_8.5.0_a2 构建镜像的用户。因 torch_npu 缺失,构建出的镜像很可能无法正常运行。文档变更不影响代码执行。

缺失关键依赖 安全漏洞 外部依赖版本跳升

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论