dragon.workflows.runtime.attach

attach(sdesc_str, oob_ssh_tunnel_override=None, remote_cwd=None)[source]

Attach to a remote Dragon runtime using a serialized descriptor.

This function establishes a connection to a remote Dragon runtime by parsing the provided serialized descriptor and setting up an out-of-band network tunnel. It creates and returns a Proxy object that can be used to switch between local and remote runtime environments.

The returned Proxy object allows processes and Dragon resources created locally to interact with the remote runtime, enabling distributed execution across systems.

Parameters:

  • sdesc_str (str ) – Serialized runtime descriptor string obtained from lookup()

  • oob_ssh_tunnel_override (str , optional) – Optional override for SSH tunnel configuration, defaults to None

  • remote_cwd (str , optional) – Current working directory to use on the remote runtime, defaults to None

Returns:

Proxy object for managing the remote runtime connection

Return type:

Proxy