FTP-Deploy-Action

What's Changed

• Update to node 20
• Update basic-ftp from 5.0.2 to 5.0.5
• Update actions/checkout to v4

What's Changed

• Update basic-ftp
• Update actions/checkout to v3
• Glob tester README link fix
• new vX.X.X tags format

Node Upgrade

• v4.3.3 upgrades node12 to node16. See github deprecation announcement

Documentation

• README updates

Node Upgrade

• v3.1.2 upgrades node12 to node16. See github deprecation announcement

Feature

• Added timeout option

Maintenance

• Upgraded basic-ftp
• Upgraded npm dependencies

Bug Fixes

• Resolves #285 "dry-run didn't work w/ dangerous-clean-slate"
• Resolves #229 "None of the available transfer modes work"

Bug Fixes

• Resolves "550 Remove directory operation failed" #220
• Resolves exclude defaults not working properly

If you are upgrading from a pervious version see the Migration Guide

Breaking changes

• The exclude format has changed, see readme for more info - Fixes #202

If you are coming from version 3 see the Migration Guide

Bug Fixes

• Cert issue - Fixes #149 and Fixes #127
• Exceptions now bubble up - Fixes #123
• Resolves local-dir incorrect usage - Fixes #145

Breaking changes

• The exclude defaults have been updated. Going forward **/.git*, **/.git*/**, **/node_modules/** will be excluded
• The exclude option now matches against folders. Previously trailing / were not matched against folders
• The security option is now loose by default (this was bugged prior to v4.1.0)

Fixes & Documentation:

• Bug where spaces were not supported within passwords

Please see the migration guide for assistance migrating from v2 to v3

Features:

• Support for known-hosts

Fixes & Documentation:

• Action does not fail even if secret is not defined #60 - Reported by @leoseyers
• Revamped readme
• Locked down actions/checkout version in examples

Please see the migration guide for assistance migrating from v2 to v3

Features:

• Upload diffs based on git history by default
• .git-ftp-ignore and .git-ftp-include support

Please see the migration guide for assistance migrating to v3

Migration Guide

Over the past few months I've been rewriting this action with a brand new architecture that resolves some long standing issues. The new version of this library is heavily inspired by rsync. rsync is a popular application that must be run over a ssh connection, it requires the rsync binary be install on both the client and the sever. rsync provides dozens of advanced arguments that can't be supported due to protocol limitations with ftp. Version 4 attempts to emulate at a high level how rsync syncs multiple folders, however operates over the constrained ftp protocol.

Less overhead

Version 4 no longer uses docker and has faster startup times!

Improved Defaults

.git and node_modules are now ignored by default, allowing users to opt-in to their deployment instead.

Improved Error Handling

Errors are now less cryptic.

Local Testing

Testing actions in version 3 was difficult, often requiring devs to change a value and commit it without testing the change locally. You can now run test configurations using node, see readme for more info.

Minimize downtime

The deployment is now setup in a way that minimizes downtime. For example, new files can be uploaded, then existing files updated, and finally old files deleted.

Removed features 🗑️

sftp support has been removed. In hindsight this never should have been added. Users with sftp access should be using rsync over ssh. I will create a separate github action for rsync deployments (coming soon)

Features:

• SFTP Support

Fixes & Documentation:

• Added SFTP example

Features:

• Updated to support the new yaml configuration
• Added ARGS option

Fixes & Documentation:

• Documentation changed to the new yaml standard
• Added examples
• Added FAQ

Automate deploying websites and more with this GitHub action.