#7175 [doc] chore: add multi machine task startup document for npu

原始 PR 作者 zhouhengan1211 合并时间 2026-07-28 17:59 文件变更 3 提交数 4 评论 2 代码增减 +225 / -1

执行摘要

NPU 用户在进行大规模训练时常需多机协同，但缺乏清晰的多机启动指南。本 PR 提供基于 Ray 和昇腾 NPU 的多机部署实践，降低用户上手成本。

建议有 NPU 多机部署需求的用户详细阅读此文档。团队成员可将其作为多机环境配置的参考模板。整体变更轻量，无需特别关注。

讨论亮点

本 PR 无实质性 Review 讨论。CLA 自动检查和 Gemini Code Assist 评论均为自动触发，未涉及设计或技术决策。PR 直接被维护者批准合并。

新增 docs/ascend_tutorial/model_support/examples/multi-machine_task_startup_practice.rst，包含前置准备、环境变量配置、启动脚本示例、常见问题排查等内容。
修改 docs/ascend_tutorial/get_start/quick_start.rst，在快速入门底部添加“多节点任务拉起”链接指向新文档。
修改 docs/ascend_tutorial/index.rst，将新文档加入教程目录 toctree。

文件	模块	状态	重要度
`docs/ascend_tutorial/model_support/examples/multi-machine_task_startup_practice.rst`	文档	added	5.21
`docs/ascend_tutorial/get_start/quick_start.rst`	文档	modified	1.72
`docs/ascend_tutorial/index.rst`	文档	modified	1.18

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

当前评论区没有形成足够清晰的争议点或结论，后续有更多讨论时会体现在这里。

纯文档变更，无回归、性能或安全风险。风险主要在于文档中的命令或配置可能存在笔误，但经过 review 已基本排除。建议用户在实际部署前根据自身环境调整参数。

对用户：为 NPU 多机训练提供可直接参考的实践指南，降低部署复杂度。对系统：无影响，仅新增文档文件及链接调整。对团队：完善了 Ascend 教程体系，提高了文档覆盖面。影响程度小。

纯文档变更

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