Skip to content

Execute commands and copy files over SSH to multiple machines at once

License

Notifications You must be signed in to change notification settings

nicholasyang2022/parallax

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Parallax SSH

Parallax SSH is a fork of Parallel SSH which focuses less on command-line tools and more on providing a flexible and programmable API that can be used by Python application developers to perform SSH operations across multiple machines.

Installation

Parallax intends to be compatible with Python 2.6 and above (including Python 3.1 and greater), but is primarily tested with Python 2.7.

Installation requires setuptools or ez_setup.py. The latter can be downloaded here.

Once those requirements are fulfilled, installation is as simple as:

# sudo python setup.py install

Packaged versions of Parallax SSH for various distributions can be downloaded from the openSUSE OBS.

To install via PyPI, use pip:

# pip install parallax

Share and enjoy!

Usage

  • parallax.call(hosts, cmdline, opts)

    Executes the given command on a set of hosts, collecting the output.

    Returns a dict mapping the hostname of each host either to a tuple containing a return code, stdout and stderr, or an parallax.Error instance describing the error.

  • parallax.copy(hosts, src, dst, opts)

    Copies files from src on the local machine to dst on the remote hosts.

    Returns a dict mapping the hostname of each host either to a path, or an parallax.Error instance describing the error.

  • parallax.slurp(hosts, src, dst, opts)

    Copies files from src on the remote hosts to a local folder for each of the remote hosts.

    Returns a dict mapping the hostname of each host either to a path, or an parallax.Error instance describing the error.

How it works

By default, Parallax SSH uses at most 32 SSH process in parallel to SSH to the nodes. By default, it uses a timeout of one minute to SSH to a node and obtain a result.

Environment variables

  • PARALLAX_HOSTS
  • PARALLAX_USER
  • PARALLAX_PAR
  • PARALLAX_OUTDIR
  • PARALLAX_VERBOSE
  • PARALLAX_OPTIONS

About

Execute commands and copy files over SSH to multiple machines at once

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%