Distributed load balance over SSH
To use this package, run the following command in your project's root directory:
This package provides sub packages which can be used individually:
distssh:distssh_common - Distributed load balance over SSH
distssh:colorlog - std.experimental.logger with color support
distssh:d2sqlite3 - A thin wrapper around SQLite 3
distssh:miniorm - A minimalistic ORM for SQLite
distssh:msgpack-ll - A low level @nogc, nothrow, @safe, pure and betterC compatible MessagePack library
distssh:sumtype - A sum type with pattern matching
distssh:unit-threaded - Advanced multi-threaded unit testing framework with minimal to no boilerplate using built-in unittest blocks
distssh is a frontend to ssh that find the least loaded host in a cluster and execute commands on it.
It can alternatively be used to find and run an interactive shell on the least loaded host.
distssh depends on the following software packages:
Download the D compiler of your choice, extract it and add to your PATH shell variable.
# example with an extracted DMD export PATH=/path/to/dmd/linux/bin64/:$PATH
Once the dependencies are installed it is time to download the source code to install distssh.
git clone https://github.com/joakim-brannstrom/distssh.git cd distssh dub build -b release
Copy the file in build/ to wherever you want to install it. When you have placed it at where you want the run the install command to setup the needed symlinks:
Done! Have fun. Don't be shy to report any issue that you find.
For distssh to be useful the environment variable DISTSSH_HOSTS has to be set.
; is used to separate hosts.
When that is done it is now ready to use!
This is the simplest usage.
distshell # or distssh --shell
distssh -- ls
Export the Environemnt to Remote Host
This is useful for those development environments where it is heavy to reload the shell with the correct modules. By exporting and then importing the environment on the remote host this can be bypassed/sped up.
Note that this basically requires them to be equivalent.
# store an export of the env distssh --export-env # now the env is reused on the remote hosts distcmd ls
It is also possible to clone the current environment without first exporting it to a file.
distssh --clone-env -- ls
These environment variables control the behavior of distssh.
DISTSSH_HOSTS: the hosts to load balance among. Hosts are separated by
export DISTSSH_HOSTS='localhost;some_remove' distcmd ls
DISTSSH_IMPORT_ENV: filename to load the environment from. Example:
export DISTSSH_IMPORT_ENV="$HOME/foo.export" distcmd ls
DISTSSH_ENV_EXPORT_FILTER: environment keys to remove when creating an export. Keys are separated by
export DISTSSH_ENV_EXPORT_FILTER='PWD;USER;USERNAME;_' distssh --export-env
- Registered by Joakim Brännström
- 2.0.1 released 3 months ago
- Copyright © 2018, Joakim Brännström
- Sub packages:
- distssh:distssh_common, distssh:colorlog, distssh:d2sqlite3, distssh:miniorm, distssh:msgpack-ll, distssh:sumtype, distssh:unit-threaded
- distssh:colorlog, distssh:distssh_common, distssh:msgpack-ll, distssh:miniorm, distssh:sumtype, distssh:d2sqlite3
2.0.1 2019-Oct-06 2.0.0 2019-Sep-30 1.1.1 2019-Jun-16 1.1.0 2018-Dec-02 1.0.0 2018-Apr-11
- Download Stats:
0 downloads today
0 downloads this week
0 downloads this month
9 downloads total
- Short URL: