SSH Cluster Control for Visual Studio Code

Configure a cluster of ssh hosts and run terminal commands simultaneously on each node. This can be useful when dealing in a distributed environment and you need to manage multiple remote compute nodes. There are predefined commands available but you can also run completely custom commands. You can easily customize the extension to add a custom command prefix/suffix to each command execution on cluster and host level.

Requirements

This extension requires OpenSSH to be installed on your machine. Most Unix based systems (Linux and Mac Os X) provide it by default. On Windows you can install ssh via Cygwin.

You can check if ssh is installed on your machine by typing ssh in your favourite system terminal.
If it shows the usage information, you are ready to go.

Features

• Configure a cluster of ssh hosts to run commands simultaneous on each node
• Open a ssh terminal for each host in the configured cluster
• Run custom terminal commands on each ssh host of the configured cluster
• Run selected text as a terminal command on each ssh host of the configured cluster
• Run one of the following predefined terminal commands on each ssh host of the configured cluster
  • initiate shutdown
  • initiate restart
  • show system info
  • show hardware info
  • show a list of running processes
  • show the free memory
  • show the current date
  • show the open ports
  • show the current working directory
  • list files in current directory
  • show the hostname
  • show the network configuration
• Configure a command prefix/postfix on cluster and ssh host level
• Supports commands for bash, cmd and powershell

Usage

1. Configure a cluster of ssh hosts. See Hosts Configuration
2. Press F1 and search for Cluster Ctrl to run any available command.

3. Alternatively, you can select some text, perform a right click and select the menu item Cluster Ctrl: Run Selection as Command.

The status bar item indicates the status of the cluster and can be used to open up the output console. Any output of the hosts of the cluster will be redirected to this view. Additionally, you can define a command prefix and postfix which for example can be used to customize the command output.

Extension Configuration

This section describes in detail how to configure a cluster of multiple ssh hosts for the extension and the additional configuration parameters that you can set.

Hosts Configuration

Configure multiple ssh host by adding a Host Definition for each host to the ctrl.cluster.hosts list property in the settings (has to be edited in the settings file). A simple ssh host entry can look like this:

"ctrl.cluster.hosts": [
        {
            "host": "192.168.178.20"
        },
    ]

This requires that you have already configured your username and key file to be used for this ssh host in your ssh configuration file ~/.ssh/config. Otherwise, you must add the user and identityFile properties. The detailed list of all supported properties of a ssh host entry can be seen in the following section.

Host Definition

A host is defined by:

Contributed Settings

This extension contributes the following settings:

Sample Configuration Snippets

This sections provides some sample configuration snippets that can be included in the settings.json file.

1. Prefix the command output of every node with their hostname:

   "ctrl.cluster.prefix": "echo -n \"[$(hostname)]\";"
   

2. Execute every command of a particular node in a specific directory:

   "ctrl.cluster.prefix": "echo -n \"[$(date +%D%T)] \";",
   "ctrl.cluster.hosts": [
       {
           "host": "192.168.178.20",
       },
       {
           "host": "192.168.178.30",
           "prefix": "cd ~/tmp && "
       },
   ]
   

3. Use ifconfig for the show network configuration command on Unix hosts:

   "ctrl.cluster.commands.networkConfiguration": {
       "bash": "ifconfig",
       "cmd": "ipconfig /all",
       "pwsh": "Get-NetIPConfiguration"
   }
   

4. Configure the cluster to use the powershell commands. Use this option if you have a cluster of Windows hosts that use powershell as default terminal:

   "ctrl.cluster.flavor": "pwsh"
   

5. Suppress any program errors of the ssh hosts when running a command on your cluster:

   "ctrl.cluster.suffix": " 2> /dev/null"
   

Change Log

The Change Log can be found here.

Contributing

Fork the repo, create a branch and submit pull requests.