EnvRunnerGroup.foreach_worker(func: Callable[[EnvRunner], T], *, local_worker: bool = True, healthy_only: bool = True, remote_worker_ids: List[int] = None, timeout_seconds: float | None = None, return_obj_refs: bool = False, mark_healthy: bool = True) List[T][source]#

Calls the given function with each EnvRunner as its argument.

  • func – The function to call for each worker (as only arg).

  • local_worker – Whether apply func on local worker too. Default is True.

  • healthy_only – Apply func on known-to-be healthy workers only.

  • remote_worker_ids – Apply func on a selected set of remote workers.

  • timeout_seconds – Time to wait for results. Default is None.

  • return_obj_refs – whether to return ObjectRef instead of actual results. Note, for fault tolerance reasons, these returned ObjectRefs should never be resolved with ray.get() outside of this WorkerSet.

  • mark_healthy – Whether to mark all those workers healthy again that are currently marked unhealthy AND that returned results from the remote call (within the given timeout_seconds). Note that workers are NOT set unhealthy, if they simply time out (only if they return a RayActorError). Also not that this setting is ignored if healthy_only=True (b/c this setting only affects workers that are currently tagged as unhealthy).


The list of return values of all calls to func([worker]).

DeveloperAPI: This API may change across minor Ray releases.