diff options
author | 2015-06-05 16:27:41 -0400 | |
---|---|---|
committer | 2015-06-05 16:27:41 -0400 | |
commit | cfaae23e64802dc0e1218ff33ee8c7326a63486b (patch) | |
tree | a6144099882a8d7a0b75eaea07b544569c6f4f16 /doc/tips | |
parent | bc5a042b5bfb1999f8450657d5b0721235fbb84c (diff) |
add new tip for public S3 remotes
Diffstat (limited to 'doc/tips')
-rw-r--r-- | doc/tips/public_Amazon_S3_remote.mdwn | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/tips/public_Amazon_S3_remote.mdwn b/doc/tips/public_Amazon_S3_remote.mdwn new file mode 100644 index 000000000..dd36b8350 --- /dev/null +++ b/doc/tips/public_Amazon_S3_remote.mdwn @@ -0,0 +1,45 @@ +Here's how to create a Amazon [[S3 special remote|special_remotes/S3]] that +can be read by anyone who gets a clone of your git-annex repository, +without them needing Amazon AWS credentials. + +## create remote + +First, export your Amazon AWS credentials: + + # export AWS_ACCESS_KEY_ID="08TJMT99S3511WOZEP91" + # export AWS_SECRET_ACCESS_KEY="s3kr1t" + +Now, create the remote: + + # git annex initremote pubs3 type=S3 encryption=none public=yes + initremote pubs3 (checking bucket) (creating bucket in US) ok + +In the above example, no encryption was used, but it will also work +if you enable eg, encryption=shared. It's also ok to enable chunking. + +The public=yes is the crtical part; this lets the public read the contents +of the bucket. + +Now, copy some files to the remote, in the usual way, and push your +git repository to someplace where someone else can access it. + +## use public remote + +Once the S3 remote is set up, anyone who can clone the git repositry +can get files from the remote, without needing any Amazon AWS credentials. + +Start by checking out the git repository. + +In the checkout, enable the S3 remote: + + # git annex enableremote pubs3 + enableremote pubs3 ok + +Now, git-annex can be used as usual to download files from that remote. + +---- + +See [[special_remotes/S3]] for details about configuring S3 remotes. + +See [[publishing_your_files_to_the_public]] for other ways to use a public +S3 bucket. |