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-29 19:12:07 +00:00
|
|
|
**Note that encrypted buckets are not (yet) supported. Data sent to S3
|
|
|
|
|
is without encryption susceptible to snooping.**
|
|
|
|
|
|
2011-03-28 06:12:05 +00:00
|
|
|
First, export your S3 credentials:
|
|
|
|
|
|
2011-03-29 19:12:07 +00:00
|
|
|
# export ANNEX_S3_ACCESS_KEY_ID="08TJMT99S3511WOZEP91"
|
|
|
|
|
# export ANNEX_S3_SECRET_ACCESS_KEY="s3kr1t"
|
2011-03-28 06:12:05 +00:00
|
|
|
|
2011-03-29 22:21:05 +00:00
|
|
|
Next, create the S3 remote, and describe it.
|
2011-03-28 06:12:05 +00:00
|
|
|
|
2011-03-29 19:12:07 +00:00
|
|
|
# git annex initremote mys3 type=S3 encryption=none
|
2011-03-29 21:20:22 +00:00
|
|
|
initremote mys3 (checking bucket) (creating bucket in US) ok
|
2011-03-29 22:21:05 +00:00
|
|
|
# git annex describe mys3 "at Amazon's US datacenter"
|
|
|
|
|
describe mys3 ok
|
2011-03-28 17:47:29 +00:00
|
|
|
|
2011-03-29 22:21:05 +00:00
|
|
|
The configuration for the S3 remote is stored in git. So to make another
|
2011-03-29 19:12:07 +00:00
|
|
|
repository use the same S3 remote is easy:
|
|
|
|
|
|
|
|
|
|
# cd /media/usb/annex
|
|
|
|
|
# git pull laptop master
|
|
|
|
|
# git annex initremote mys3
|
2011-03-29 20:21:21 +00:00
|
|
|
initremote mys3 (checking bucket) ok
|
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.
|
