git-annex/doc/tips/using_Amazon_S3.mdwn

38 lines
1.4 KiB
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.
First, export your Amazon AWS credentials:
2011-03-28 06:12:05 +00:00
2012-05-30 00:27:23 +00:00
# export AWS_ACCESS_KEY_ID="08TJMT99S3511WOZEP91"
# export AWS_SECRET_ACCESS_KEY="s3kr1t"
2011-03-28 06:12:05 +00:00
2011-04-16 23:30:31 +00:00
Now, create a gpg key, if you don't already have one. This will be used
to encrypt everything stored in S3, for your privacy. Once you have
a gpg key, run `gpg --list-secret-keys` to look up its key id, something
like "2512E3C7"
Next, create the S3 remote, and describe it.
2011-03-28 06:12:05 +00:00
# git annex initremote cloud type=S3 encryption=2512E3C7
initremote cloud (encryption setup with gpg key C910D9222512E3C7) (checking bucket) (creating bucket in US) (gpg) ok
# git annex describe cloud "at Amazon's US datacenter"
describe cloud 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
# git annex initremote cloud
initremote cloud (gpg) (checking bucket) ok
2011-03-28 06:12:05 +00:00
Now the remote can be used like any other remote.
# git annex copy my_cool_big_file --to cloud
copy my_cool_big_file (gpg) (checking cloud...) (to cloud...) ok
# git annex move video/hackity_hack_and_kaxxt.mov --to cloud
move video/hackity_hack_and_kaxxt.mov (checking cloud...) (to cloud...) ok
2011-03-28 02:52:13 +00:00
See [[special_remotes/S3]] for details.