Files
2026-07-13 13:17:40 +08:00

28 lines
1.1 KiB
ReStructuredText

.. _forking-ray-processes-antipattern:
Anti-pattern: Forking new processes in application code
========================================================
**Summary:** Don't fork new processes in Ray application code—for example, in
driver, tasks or actors. Instead, use the "spawn" method to start new processes or use Ray
tasks and actors to parallelize your workload
Ray manages the lifecycle of processes for you. Ray Objects, Tasks, and
Actors manage sockets to communicate with the Raylet and the GCS. If you fork new
processes in your application code, the processes could share the same sockets without
any synchronization. This can lead to corrupted messages and unexpected
behavior.
The solution is to:
1. use the "spawn" method to start new processes so that the parent process's
memory space is not copied to the child processes or
2. use Ray tasks and
actors to parallelize your workload and let Ray manage the lifecycle of the
processes for you.
Code example
------------
.. literalinclude:: ../doc_code/anti_pattern_fork_new_processes.py
:language: python