Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@zodern/nodemiral

Package Overview
Dependencies
Maintainers
1
Versions
9
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@zodern/nodemiral

Server Automation for NodeJS over SSH

  • 1.4.1
  • latest
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source

nodemiral (node + admiral) Build Status

Server Automation for NodeJS over SSH

Fork of https://github.com/arunoda/nodemiral

Changes:

  • Update ssh2 and other dependencies
  • Fix testing on windows

Install

npm install @zodern/nodemiral

Features

  • Support connecting to any unix remote server
  • Authenticate with password(using sshpass) or with a pem file
  • Can work with multiple servers at once
  • Supports, copy, execute and executeScript at core methods
  • Familiar NodeJS API

Example

var nodemiral = require('@zodern/nodemiral');
var session = nodemiral.session('hostname', {username: 'root', password: 'password'});

session.execute('uname -a', function(err, code, logs) {
  console.log(logs.stdout);
});

API

Session

Create a session to a remote server. You can invoke following methods after created a session

@param hostname - hostname or ip addess
@param auth - object containing following fields: `username` and (`password` or `pem`)
@param options - object of options described below
nodemiral.session(hostname, auth, options);

options:

  • ejs - ejs options with ejs fields
  • ssh - object whose key and value will be passed as -o key:value to any ssh session. For example { 'StrictHostKeyChecking': 'no', 'UserKnownHostsFile': '/dev/null' }

Session Methods

execute

execute given shell command on the remote server

@param shellCommand - shellCommand
@param options - {onStdout, onStderr}
@param callback - callback containing following parameters
  err - err if exists
  code - status code of the ssh process
  logs - {stdout: 'stdout logs', stderr: 'stderr logs'}
session.execute(shellCommand, callback);
executeScript

execute a local shell script in the remote server. You can template shell script with EJS.

@param localScriptFile - localScriptFile
@param options.vars - variables to the template if uses ejs in the script
@param callback - callback containing following parameters
  err - err if exists
  code - status code of the ssh process
  logs - {stdout: 'stdout logs', stderr: 'stderr logs'}
session.executeScript(localScriptFile, options, callback);
copy

copy a file from local machine to the remote machine. Supports binary files too. Support EJS templating with non-binary files

@param localFile - localFile
@param remoteFileLocation - remoteFileLocation
@param options.vars - templateVars
@param optiosn.progressBar - show progress bar
@param callback - callback containing following parameters
  err - err if exists
  code - status code of the ssh process
  logs - {stdout: 'stdout logs', stderr: 'stderr logs'}
session.copy(localFile, remoteFileLocation, options, callback)

FAQs

Package last updated on 27 Jun 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc