Have opinions about JavaScript? We want to hear them. Take the 2018 JavaScript Ecosystem Survey »

ftp-deploy

2.2.1 • Public • Published

ftp-deploy

A Node.js package to help with deploying code. Ftp a folder from your local disk to a remote ftp destination. Does not delete from destination directory.

Version 2.0.0 is an almost complete re-write to use promises and promise-ftp instead of jsftp. The one breaking change is listed in the Usage section.

Installation

npm install --save-dev ftp-deploy

Usage

I create a file - e.g. deploy.js - in the root of my source code and add a script to its package.json so that I can npm run deploy.

"scripts"{
    "deploy": "node deploy"
},

The most basic usage (stops uploading when an error occurs): Note: that in version 2 the config file expects a field of user rather than username in 1.x.

The config file is passed as-is to Promise-FTP.

var FtpDeploy = require('ftp-deploy');
var ftpDeploy = new FtpDeploy();
 
var config = {
    user: "user",                   // NOTE that this was username in 1.x 
    password: "password",           // optional, prompted if none given
    host: "ftp.someserver.com",
    port: 21,
    localRoot: __dirname + '/local-folder',
    remoteRoot: '/public_html/remote-folder/',
    // include: ['*', '**/*'],      // this would upload everything except dot files
    include: ['*.php', 'dist/*'],
    exclude: ['dist/**/*.map'],     // e.g. exclude sourcemaps - ** exclude: [] if nothing to exclude **
    deleteRemote: true,              // delete existing files at destination before uploading
    forcePasv: true                 // Passive mode is forced (EPSV command is not sent)
}
 
// use with promises
ftpDeploy.deploy(config)
    .then(res => console.log('finished'))
    .catch(err => console.log(err))
    
// use with callback
ftpDeploy.deploy(config, function(err) {
    if (err) console.log(err)
    else console.log('finished');
});

Configuration

You need to list all file patterns that you want to include for uploading, and the exclude option enables exceptions to the rule

  • include: all files that match will be uploaded. Note that a [ ] matches nothing
  • exclude: if a file matches the include pattern a subset may nonetheless be excluded

Events

To be notified of what ftpDeploy is doing:

ftpDeploy.on('uploading', function(data) {
    data.totalFilesCount;       // total file count being transferred
    data.transferredFileCount; // number of files transferred
    data.filename;             // partial path with filename being uploaded
});
ftpDeploy.on('uploaded', function(data) {
    console.log(data);         // same data as uploading event
});
ftpDeploy.on('log', function(data) {
    console.log(data);         // same data as uploading event
});

To continue uploading files even if a file upload fails (not implemented at present):

ftpDeploy.on('upload-error', function (data) {
    console.log(data.err); // data will also include filename, relativePath, and other goodies
});

Testing

A script to run a simple ftp server (using ftp-srv) is included, together with a test directory.

To use open a console to run the ftp server:

npm run test_server

and then in another console run the tests:

npm test

ToDo

re-enable continueOnError Move uploading and uploaded events to log

Keywords

install

npm i ftp-deploy

Downloadsweekly downloads

2,105

version

2.2.1

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
Report a vulnerability