git-annex/doc/walkthrough/using_Amazon_S3.mdwn

26 lines
919 B
Text
Raw Normal View History

2011-03-28 02:52:13 +00:00
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.
2011-03-28 06:12:05 +00:00
First, export your S3 credentials:
export ANNEX_S3_ACCESS_KEY_ID="08TJMT99S3511WOZEP91"
export ANNEX_S3_SECRET_ACCESS_KEY="s3kr1t"
Next, create the remote.
2011-03-28 06:12:05 +00:00
2011-03-29 03:22:31 +00:00
git annex initremote mys3 type=S3 encryption=none
initremote (creating bucket mys3-291d2fdc-5990-11e0-909a-002170d25c55...) ok
2011-03-28 17:47:29 +00:00
**Note that encrypted buckets are not (yet) supported. Data sent to S3
2011-03-29 02:05:11 +00:00
is without encryption susceptible to snooping.**
2011-03-28 06:12:05 +00:00
Now the remote can be used like any other remote.
2011-03-28 02:52:13 +00:00
# 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
2011-03-28 17:47:29 +00:00
See [[special_remotes/Amazon_S3]] for details.