git-annex/doc/walkthrough/using_Amazon_S3.mdwn
2011-03-28 23:22:31 -04:00

25 lines
919 B
Markdown

git-annex extends git's usual remotes with some [[special_remotes]], that
are not git repositories. This way you can set up a remote using say,
Amazon S3, and use git-annex to transfer files into the cloud.
First, export your S3 credentials:
export ANNEX_S3_ACCESS_KEY_ID="08TJMT99S3511WOZEP91"
export ANNEX_S3_SECRET_ACCESS_KEY="s3kr1t"
Next, create the remote.
git annex initremote mys3 type=S3 encryption=none
initremote (creating bucket mys3-291d2fdc-5990-11e0-909a-002170d25c55...) ok
**Note that encrypted buckets are not (yet) supported. Data sent to S3
is without encryption susceptible to snooping.**
Now the remote can be used like any other remote.
# git annex copy my_cool_big_file --to mys3
copy my_cool_big_file (to mys3...) ok
# git annex move video/hackity_hack_and_kaxxt.mov --to mys3
move video/hackity_hack_and_kaxxt.mov (to mys3...) ok
See [[special_remotes/Amazon_S3]] for details.