git-ftp

by git-ftp

git-ftp / git-ftp

Uses Git to upload only changed files to FTP servers.

4.8K Stars 630 Forks Last release: 9 months ago (1.6.0) GNU General Public License v3.0 1.0K Commits 47 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Git-ftp -- uploads to FTP servers the Git way

If you use Git and you need to upload your files to an FTP server, Git-ftp can save you some time and bandwidth by uploading only those files that changed since the last upload.

It keeps track of the uploaded files by storing the commit id in a log file on the server. It uses Git to determine which local files have changed.

You can easily deploy another branch or go back in the Git history to upload an older version.

# Setup
git config git-ftp.url "ftp://ftp.example.net:21/public_html"
git config git-ftp.user "ftp-user"
git config git-ftp.password "secr3t"

Upload all files

git ftp init

Or if the files are already there

git ftp catchup

Work and deploy

echo "new content" >> index.txt git commit index.txt -m "Add new content" git ftp push

1 file to sync:

[1 of 1] Buffered for upload 'index.txt'.

Uploading ...

Last deployment changed to ded01b27e5c785fb251150805308d3d0f8117387.

If you encounter any problems, add the

-v
or
-vv
option to see more output. The manual may answer some of your questions as well.

Further Reading

Limitations

  • Windows and OS X: I am very limited in testing on Windows and OS X. Thanks for helping me out fixing bugs on these platforms.
  • git-ftp as deployment tool: git-ftp was not designed as centralized deployment tool. While a commit is being pushed and uploaded to the FTP server, all files belonging to that revision must remain untouched until git-ftp has successfully finished the upload. Otherwise, the contents of the uploaded file will not match the contents of the file referenced in the commit.

Contributions

Don't hesitate to improve this tool. Don't forget to add yourself to the AUTHORS file. The core functionality is unit tested using shunit2. You can find the tests in

tests/
.

Copyright

This application is licensed under GNU General Public License, Version 3.0

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.