Actions/FTP-Deploy-Action
1
Fork 0
mirror of https://github.com/SamKirkland/FTP-Deploy-Action.git synced 2025-08-14 14:05:05 +00:00
Code Issues Packages Projects Releases Wiki Activity
FTP-Deploy-Action/migration.md
SamKirkland 59992de6c6 v4.1.0 
Cert issue - Fixes #149 and Fixes #127
Exceptions now bubble up - Fixes #123
Resolves local-dir incorrect usage - Fixes #145
2021-06-22 23:59:51 -05:00

1.8 KiB
Raw Blame History

Migrating from v3 to v4

Migrating from v3 to v4 should be fairly straightforward. Version 4 was designed with speed and ease of initial setup in mind. Going forward version 4 will be the only supported version.

Those who can't upgrade

Most features have been carried forward and improved upon. However, some features did not make the cut.

  • sftp is no longer supported. If you have sftp access you are using ssh, that means you have access to a much more modern and capable protocol. I plan on releasing a separate github action that will deploy over sftp/ssh using rsync. Until then you can continue using version 3.
  • The include argument has been removed. I didn't see much need for it in the initial release. If you need this feature please create a support ticket.

How to upgrade

  1. Remove with: fetch-depth: 2. It is no longer needed and removing it will slightly speed up deployments.
  2. Change the version to 4.X.X, for example SamKirkland/FTP-Deploy-Action@4.1.0 (please check readme for latest version)
  3. If you have a .git-ftp-include file you should delete it. Version 4 tracks files differently and no longer needs this config file.
  4. If you have a .git-ftp-ignore file, you should transfer the options to the new exclude argument. Note: Version 4 excludes any .git* and node_modules/ files/folders by default
  5. Update your arguments to reflect the following changes
    • ftp-server was split into 4 arguments. server, port, protocol, and server-dir. Transfer your config to these options as needed.
    • ftp-username was renamed to username
    • ftp-password was renamed to password
    • local-dir and server-dir now must end with /
    • git-ftp-args and known-hosts arguments were removed