From d5581527117710e2c356fa22cb0b9f279544f319 Mon Sep 17 00:00:00 2001 From: jiaqiw09 Date: Sun, 15 Mar 2026 22:56:57 +0800 Subject: [PATCH 1/2] update ray doc --- index.rst | 1 + sources/ascend/ray.rst | 126 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 127 insertions(+) create mode 100644 sources/ascend/ray.rst diff --git a/index.rst b/index.rst index 48247751..fdb5ea29 100644 --- a/index.rst +++ b/index.rst @@ -348,6 +348,7 @@ sources/kernels/index.rst sources/pytorch/index.rst sources/transformers/index.rst + sources/ascend/ray.rst .. toctree:: :maxdepth: 1 diff --git a/sources/ascend/ray.rst b/sources/ascend/ray.rst new file mode 100644 index 00000000..b0fe6f8a --- /dev/null +++ b/sources/ascend/ray.rst @@ -0,0 +1,126 @@ +Ray +=== + +本篇指南介绍了如何在 Ascend NPU 环境下快速安装和使用 Ray。借助于 Ray 的分布式能力,您可以更高效地管理集群资源和分布式计算任务。 + +安装说明 +-------- + +在 Ascend 上安装 Ray 非常简单,不需要复杂的系统依赖配置。我们推荐以下安装方式: + +.. code-block:: bash + + pip install ray>=2.46.0 + +启动与作业运行 +-------------- + +Ray 提供了一套简单易用的命令行工具,方便您在单机或多机环境下快速拉起守护进程并提交任务。 + +1. 启动 Ray 节点 +^^^^^^^^^^^^^^^^ + +- **单机启动(默认作为主节点)**: + + .. code-block:: bash + + ray start --head + +- **多机启动(工作节点加入主节点)**: + + 在子节点上执行以下命令(替换 ``IP`` 为主节点的真实 IP): + + .. code-block:: bash + + ray start --address=':6379' + +2. 提交与管理作业 (Job) +^^^^^^^^^^^^^^^^^^^^^^^ + +推荐使用 Ray Job 的方式提交任务。 **这种方式提交的脚本会默认在集群后台运行** ,即便您的终端意外关闭或 SSH 断开,任务也不会中断,极大地提升了稳定性。 + +- **提交任务**: + + .. code-block:: bash + + ray job submit --working-dir . -- python your_script.py + + *(提交后,系统会返回一个* ``job_id`` *,例如:* ``raysubmit_xxxx`` *)* + +- **查看任务列表**: + + .. code-block:: bash + + ray job list + +- **停止运行中的任务**: + + .. code-block:: bash + + ray job stop + +.. note:: + **💡 框架集成运行方式补充说明:** + + 如果您使用的是已经深度集成 Ray 的上层框架(例如某些大模型微调框架会自己在代码中拉起 Ray 集群),您完全可以继续使用框架原有的命令(例如直接运行 ``python scripts.py`` 或 ``bash run.sh`` 等)。 + + **区别在于** :通过这种原生方式直接运行的进程,其日志 **大部分会实时输出在当前终端,且进程不处于后台** 。如果您关闭终端进程就会被 kill。您可以根据自己的使用习惯(后台挂机 vs 实时监控)来选择启动方式。 + + **结合** ``ray job submit`` **实现后台运行** : + + 如果您既想使用其他框架的原生启动脚本,又希望让其在后台稳定运行,可以将其与 ``ray job submit`` 结合使用。只要集群提前通过 ``ray start`` 拉起,您就可以如下提交框架脚本: + + .. code-block:: bash + + ray job submit --working-dir . -- bash run_framework.sh + +Ray 集群环境变量配置 +-------------------- + +Ray 的环境变量配置有一个 **核心原则** : **所有影响集群行为的环境变量必须在 Ray 节点启动(ray start)之前声明,或者在提交 Job 时通过专用参数传入。** + +如果在 ``ray start`` 之后才执行 ``export`` ,这些环境变量对已经运行的 Ray 进程(包括由 Ray 调度的 Worker 进程)是 **无效的** 。 + +以下以 ``RAY_DEDUP_LOGS`` (日志去重功能)为例,展示正确的环境变量配置方式: + +**示例场景:禁用日志去重** + +Ray 默认会折叠大量重复的日志。在调试 NPU 问题时,为了防止关键的硬件报错信息被“去重”隐藏,我们通常需要禁用此功能。 + +**正确配置方式 1:集群启动前全局设定(推荐)** + +在执行 ``ray start`` 之前设置环境变量,该变量会对该节点上后续启动的所有 Ray 进程生效。 + +.. code-block:: bash + + export RAY_DEDUP_LOGS=0 + ray start --head + +**正确配置方式 2:使用** ``ray job submit`` **针对特定作业生效** + +如果您不想重启集群,也可以在提交任务时通过 ``--runtime-env-json`` 将环境变量注入到该任务的运行环境中。 + +.. code-block:: bash + + # 举例:仅对本次提交的脚本禁用日志去重 + ray job submit --runtime-env-json '{"env_vars": {"RAY_DEDUP_LOGS": "0"}}' -- python your_script.py + +ray start 常用参数说明 +---------------------- + +虽然绝大部分用户只需使用基础的 ``ray start --head`` 就能跑通全流程,但如果您在复杂组网或者多用户共享服务器的情况下使用 Ray,可以了解并在第二步的启动流程中加入这些进阶参数: + +- ``--port`` + 指定 Ray 头部节点通信的端口(默认值为 ``6379``)。如果在同一台宿主机上有多个人需要各自启动 Ray 集群,可以通过指定不同的端口以避免冲突。 + *示例:* ``ray start --head --port=6380`` + +- ``--temp-dir`` + 自定义 Ray 的临时文件目录。Ray 默认会将大量的运行日志和临时文件写在 ``/tmp/ray`` 目录下。长期运行的重负载任务如果塞满宿主机 ``/tmp`` 目录会导致机器无法工作。建议将其指向空间更大的数据盘。 + *示例:* ``ray start --head --temp-dir=/data/ray_tmp`` + +- ``--dashboard-host`` 与 ``--dashboard-port`` + Ray 提供了功能强大的可视化监控大盘。默认情况下,Dashboard 只绑定 ``127.0.0.1``,此时外部浏览器无法访问。如果需要通过局域网直接查看 UI,可以将 host 设为全局并自定义网页端口。 + *示例:* ``ray start --head --dashboard-host=0.0.0.0 --dashboard-port=8265`` + +- ``--num-cpus`` 与 ``--num-gpus`` + 显式声明当前节点提供给 Ray 集群的 CPU 核心数和加速卡数。通常 Ray 能够自动检测到机器的总资源,但当您只想划分机器的“一半”资源给 Ray 调度时,可以直接强行指定。 From 31f4b2aeaff85bcd89fde637e1718562c477e1a9 Mon Sep 17 00:00:00 2001 From: root <15750543867@163.com> Date: Tue, 31 Mar 2026 19:53:26 +0800 Subject: [PATCH 2/2] Refactor directory layout --- _static/images/ray.png | Bin 0 -> 34688 bytes index.rst | 9 ++++++++- sources/Ray/index.rst | 7 +++++++ sources/{ascend/ray.rst => Ray/quick_start.rst} | 4 ++-- 4 files changed, 17 insertions(+), 3 deletions(-) create mode 100644 _static/images/ray.png create mode 100644 sources/Ray/index.rst rename sources/{ascend/ray.rst => Ray/quick_start.rst} (99%) diff --git a/_static/images/ray.png b/_static/images/ray.png new file mode 100644 index 0000000000000000000000000000000000000000..721870e8d67f94b42df2c1fa4b252b4bb5172078 GIT binary patch literal 34688 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 +
+

Ray

+

Ray is a unified framework for scaling AI and Python applications.

+ +
+ +

pytorch

PyTorch AI 框架,2.1 版本起官方原生支持昇腾 NPU。

@@ -347,8 +354,8 @@ sources/deepspeed/index.rst sources/kernels/index.rst sources/pytorch/index.rst + sources/Ray/index.rst sources/transformers/index.rst - sources/ascend/ray.rst .. toctree:: :maxdepth: 1 diff --git a/sources/Ray/index.rst b/sources/Ray/index.rst new file mode 100644 index 00000000..70ee790b --- /dev/null +++ b/sources/Ray/index.rst @@ -0,0 +1,7 @@ +Ray +============ + +.. toctree:: + :maxdepth: 2 + + quick_start.rst diff --git a/sources/ascend/ray.rst b/sources/Ray/quick_start.rst similarity index 99% rename from sources/ascend/ray.rst rename to sources/Ray/quick_start.rst index b0fe6f8a..1eb39371 100644 --- a/sources/ascend/ray.rst +++ b/sources/Ray/quick_start.rst @@ -1,5 +1,5 @@ -Ray -=== +快速开始 +======= 本篇指南介绍了如何在 Ascend NPU 环境下快速安装和使用 Ray。借助于 Ray 的分布式能力,您可以更高效地管理集群资源和分布式计算任务。