执行摘要
本次 PR 更新了 DAPO 多模型优化实践文档,使硬件和软件版本适配 verl v0.7.1,包括升级 CANN、torch、vllm 等组件,并新增性能相关环境变量。变更仅涉及文档,无源码风险。
功能与动机
使 DAPO 多模型优化实践教程与 verl v0.7.1 版本的软件栈和推荐硬件平台保持一致,确保用户按文档操作时能正确运行。
实现拆解
- 更新硬件要求:将硬件配置从 "2 台 Atlas 800T A3" 改为 "1 台 Atlas 900 A3 SuperPoD",反映推荐的最低硬件平台变更。
- 升级软件版本表:
- CANN: 8.3.RC1 → 8.5
- torch: 2.7.1 → 2.8.0
- torch_npu: 2.7.1 → 2.8.0
- verl: 特定 commit → v0.7.1 标签
- vllm: 0.11.0 → 0.13.0
- vllm-ascend: 0.11.0-dev → 0.13.0
- transformers: 4.57.3 → 4.57.6
- 修正 git checkout 命令:将
git checkout 252d7690... 改为 git checkout release/v0.7.1(后经 review 修正为与版本表一致的 commitID)。
- 新增性能环境变量:在脚本中增加
CPU_AFFINITY_CONF=2 和 HCCL_OP_EXPANSION_MODE="AIV",用于绑定 CPU 亲和性和优化 HCCL 通信。
- 修复 URL 中的空格编码:将训练脚本路径中的
%20 替换为实际下划线,使链接正确跳转。
无(仅文档变更)。
评论区精华
Review 评论(gemini-code-assist[bot]):"命令使用了分支名 release/v0.7.1,与文档中应使用特定 commitID 以避免问题的说明矛盾。建议使用环境表列出的 commitID 以确保可重现性。"
提交历史显示第二个 commit [docs] update pinned verl commit id 已将分支名替换为特定 commitID,评论建议已被采纳。
风险与影响
风险:无技术风险,仅文档变更,不影响源码逻辑。若用户使用与文档不同的版本可能遇到问题,但文档本身即为正确指引。
影响:仅影响阅读此教程的用户,提供更准确的环境配置信息。不改变系统功能或 API,无向后兼容性问题。
关联脉络
该 PR 本身为独立的文档维护更新,与近期 CI/NPU 相关 PR(如 #6106、#6098、#6102)共同体现了对 Ascend NPU 平台支持的持续优化和版本同步。
参与讨论