✕
The Wayback Machine - https://web.archive.org/web/20171106145500/https://www.npmjs.com/package/ssh-deploy
node package manager
Easy collaboration. Discover, share, and reuse code in your team. Create a free org »

ssh-deploy

Usage

ssh-deploy env-get       <remote> [options] Get the value of an environment variable for a given host.
 
  options:
 
    --host      The host is the domain name that an application is made accessible at
    --name      The name of the environment variable
 
ssh-deploy env-list      <remote> [options] Get the value of all environment variables for a given host.
 
  options:
 
    --host      The host is the domain name that an application is made accessible at
 
ssh-deploy env-set       <remote> [options] Set the value of an environment variables for a given host.
 
  options:
 
    --host      The host is the domain name that an application is made accessible at
    --name      The name of the environment variable
    --value     The value of the environment variable
 
ssh-deploy prepare       <remote>           Prepare a server to be used for ssh-deploy
 
ssh-deploy publish       <remote> [options] Publish a new version of an application.
 
  options:
 
    --directory The directory of the application, defaults to the current working directory
    --app       The name of the application (defaults to name, read from package.json)
    --version   The version of teh application (default to version, read from package.json)
 
ssh-deploy restart-agent <remote>           Restarts the bouncy proxy that is responsible for mapping hosts onto ports
 
ssh-deploy start         <remote> [options] Start or restart an application at a given host and version.
 
  options:
 
    --app       The name of the application (defaults to name, read from package.json)
    --version   The version of teh application (default to version, read from package.json)
    --host      The host is the domain name that an application is made accessible at

API

Each command can also be accessed programatically by calling deploy[command](remote, options), and will return a promise. e.g.

var deploy = require('ssh-deploy');
deploy.publish('root:password@127.0.0.1', {directory: process.cwd}).then(function () {
  return deploy.start('root:password@127.0.0.1', {directory: process.cwd, host: 'example.com'});
}).done(function () {
  console.log('updated deployment');
});

Auto Complete and Naming Hosts

To configure a .ssh/config file see http://nerderati.com/2011/03/17/simplify-your-life-with-an-ssh-config-file/

To enable tab auto-complete run one of the following commands (depending on your system:

ssh-deploy completion >> ~/.bash_profile
ssh-deploy completion >> ~/.bashrc
ssh-deploy completion >> ~/.zshrc

This is exactly like adding completion to npm. Note that it will only auto-complete the command name and the server name (if you have a .ssh/config file).

how? learn more

Collaborators list

Stats

Try it out

Keywords

None

Dependencies (9)

concat-stream, fstream-npm, minimist, promise, semver, ssh2, sshconf-stream, tabtab, tar-pack