fix(docs): Ray 在 armv7 上确实能跑——更正错误结论并附实测

用户指出社区编过 ray 1.0.1 armv7l wheel。核实为真,之前的"不可能"是错的。

PyPI 侧仍是事实:135 个版本 5087 个 wheel,armv7l/armhf/armv6 共 0 个,
piwheels 全 skip(binary only),无 sdist。但社区有人编:
- PidgeyBE 1.0.1 (cp36)、PeterPirog 1.2.0 (cp38),issue #12128
- 唯一需要的改动是 setup.py 加 --linkopt=-latomic(8 字节原子要 libatomic)

实物核对(ray-1.0.1-cp36-cp36m-linux_armv7l.whl,19MB→64MB):
_raylet.so 16.4MB / raylet 13.1MB / gcs_server 10.9MB,
全部 ELF32 ARM EABI5 hard-float;_raylet.so 导出 2040 个 ray:: 符号,
CoreWorkerProcess::Initialize/GetCoreWorker/RunTaskExecutionLoop 齐全,
无 B5cxx11(同样是旧 ABI),所以 shim 那套做法在 armv7 也成立。

实测跑通完整节点(x86_64 沙箱 + qemu-arm-static 真 ELF32 执行):
redis(带 ray 模块) → gcs_server:6392 → plasma → raylet:6393,
NodeManager ID ebb89cb9…,GCS 回 IsAlive = 1。

顺带记三个非 32 位坑:redis 要手工播种 5 个键;容器 /dev/shm 64MB 要改
plasma 目录;raylet 硬性要求一个 worker_command。

代价也说清:1.0.1 是 2020-12 代码,GCS 协议与 2.x 不同,接不进现代集群;
cp36 要 python3.6;44.6MB 二进制。默认仍走 nax-orch。

新增 docs/RAY_ARMV7.md + ray/armv7/{run_node,run_gcs_only}.sh;
RAY_CORE.md §5 与状态表改正。
This commit is contained in:
rong committed 2026-10-30 12:07:19 +08:00
1 parent 4bb573d98c
commit d60fcf40ca
4 files changed
+275 -9

No files matched your search

+18 -9
View File
@@ -11,7 +11,7 @@
| 是否需要 bazel | **否**。复用 pip wheel 里的预编译 `_raylet.so` |
| 编译耗时 | 90 秒(含生成 68 个 protobuf 头 + 2 个 flatbuffers) |
| 运行时硬依赖 | 44 MB `_raylet.so` + 40 MB `gcs_server` + 35 MB `raylet` + libpython |
| 能不能进 armv7 | **不能**。`_raylet.so` 只有 x86_64/aarch64 版,且 32 位无对应构建 |
| 能不能进 armv7 | **能**(社区 1.0.1/1.2.0 有 armv7l wheel,已实测跑通完整节点,见 [RAY_ARMV7.md](RAY_ARMV7.md));2.59 官方无 armv7 版 |
| 拿到的能力 | 集群成员 / 节点资源标签 / driver 身份;**不接管计算** |
结论:Ray 只当「集群目录 + 放置」用,计算仍然走 nax 自己的帧。
@@ -98,17 +98,26 @@ cxx11 ABI 的 libprotobuf。
## 5. armv7 / Zynq 的结论
**这条路 Zynq 上不通**,三层原因,任一层都足够:
**先纠正一个曾经的错误结论**:Ray 在 armv7 上是能跑的。PyPI 没有,但社区编过
1.0.1 / 1.2.0 的 armv7l wheel,唯一需要的源码改动是 `--linkopt=-latomic`
(32 位 ARM 的 8 字节原子操作要显式链 libatomic)。2026-10-30 实测:用 qemu-arm
起 redis + gcs_server + plasma + raylet,节点注册进 GCS 拿到 `IsAlive = 1`。
完整记录见 [RAY_ARMV7.md](RAY_ARMV7.md)。
1. PyPI 没有 32 位 ARM 的 ray wheel,`_raylet.so` 不存在;
2. 就算自己编,Ray 的 bazel 只有 `linux_x86_64` / `linux_arm64` 两个平台定义,
armv7 要自己写完整 toolchain(38 个第三方便全部要跟着过一遍);
3. 44 MB 的 `.so` + 40 MB gcs_server 塞进 512 MB DDR 的边缘盒子,本身就是反目标。
但「能跑」不等于「该用」,代价是三条:
1. 版本停在 2020 年底(1.0.1 / 1.2.0),GCS 协议与 2.x 不同,**接不进现代 Ray 集群**;
2. wheel 是 cp36,`_raylet.so` 是 CPython 扩展,板上要 python3.6 或链 libpython 兜符号;
3. C++ 侧 44.6 MB 二进制 + plasma 内存。ACZ7015 的 1 GB DDR3 放得下,512 MB 的板子悬。
自己编 2.59 的 armv7 版不建议:要给 bazel 写完整 armv7 crosstool,38 个第三方依赖
全部跟着过一遍,还要面对未知数量的 32 位问题——而我们只用它「放置」这一项能力。
所以最终分工:
- **Zynq / 边缘**:nax 自己的编排(`nax-orch`,661 行纯 std,已跑通 3/4 方)+ 交叉编译单二进制;
- **x86 集群**:可选接 Ray 做成员与放置。
- **x86 集群**:可选接 Ray 做成员与放置;
- **确需边缘 Ray 生态时**:走 [RAY_ARMV7.md](RAY_ARMV7.md) 的 1.0.1 路线。
这也回答了最初的问题:Ray 的 C++ 内核**可以**给 Rust 集成,但它的价值在
「大集群的成员管理」,不在「边缘设备的隐私计算」。
这也回答了最初的问题:Ray 的 C++ 内核**可以**给 Rust 集成,在 armv7 上也**可以**跑,
但它的价值在「大集群的成员管理」,不在「边缘设备的隐私计算」。