actions/FTP-Deploy-Action
1
0
Fork 0
mirror of http://43.153.184.91:8080/https://github.com/SamKirkland/FTP-Deploy-Action.git synced 2026-01-27 11:13:02 +08:00
Code Issues Packages Projects Releases Wiki Activity
FTP-Deploy-Action/migration.md
SamKirkland 16956be3a6 4.3.1 release 
Upgrade basic-ftp library
Update npm libraries
Resolves #308
2022-08-21 21:21:46 -05:00

2.0 KiB
Raw Blame History

Migrating from v4.1.0 to v4.2.0

v4.2.0 parses the exclude option in a more standard way.

Going forward the exclude option must be in the following format

exclude: |
  **/.git*
  **/.git*/**
  **/node_modules/**
  fileToExclude.txt

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.3.1 (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