workflow remote

Synopsis

workflow remote <verb> [arguments...] [flags...]

Description

Registers, provisions, synchronizes, and manages remote HPC systems, Slurm worker allocations, and auto-schedulers. Running workflow remote bare automatically displays all registered remotes and connection states.

Available Verbs

  • print [name]: Displays registered remote host configurations, paths, and connectivity status (default action).

  • add <name> <host>: Registers a remote host globally in ~/.config/snap_workflow/remotes.json.

  • setup <name> <path>: Initializes and validates remote directory structure, environment profiles, and Slurm capabilities.

  • sync <name> [–pull|–push|–both]: Synchronizes code, parameters, worker logs, statuses, and auto-sync outputs between local and remote environments.

  • connect <name>: Opens an interactive SSH session to the remote host, establishing reverse SSH tunnels.

  • reserve <remote> <profile> [–num-workers N]: Submits and reserves persistent Slurm worker compute allocations on the cluster.

  • auto [target]: Launches autonomous scheduling on the target machine (defaults to local).