mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

deal with Amazon S3 breaking change for public=yes

Browse source 
* S3: Amazon S3 buckets created after April 2023 do not support ACLs,
  so public=yes cannot be used with them. Existing buckets configured
  with public=yes will keep working.
* S3: Allow setting publicurl=yes without public=yes, to support
  buckets that are configured with a Bucket Policy that allows public
  access.

Sponsored-by: Joshua Antonishen on Patreon
This commit is contained in:
Joey Hess 2023-07-21 13:48:49 -04:00
parent ddc7f36d53
commit 33ba537728
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
7 changed files with 105 additions and 23 deletions
Download patch file Download diff file Expand all files Collapse all files

19
doc/special_remotes/S3.mdwn
View file

@ -125,15 +125,18 @@ the S3 remote.
When versioning is not enabled, this risks data loss, and so git-annex
will not let you enable a remote with that configuration unless forced.
* `public` - Set to "yes" to allow public read access to files sent
to the S3 remote. This is accomplished by setting an ACL when each
file is uploaded to the remote. So, changes to this setting will
only affect subseqent uploads.
* `publicurl` - Configure the URL that is used to download files
from the bucket. Using this in combination with public=yes allows
git-annex to download files from the S3 remote without needing to
know the S3 credentials.
from the bucket. Using this with a S3 bucket that has been configured
to allow anyone to download its content allows git-annex to download
files from the S3 remote without needing to know the S3 credentials.
To configure the S3 bucket to allow anyone to download its content,
refer to S3 documentation to set a Bucket Policy.
* `public` - Deprecated. This enables public read access to files sent to
the S3 remote using ACLs. Note that Amazon S3 buckets created after April
2023 do not support using ACLs in this way and a Bucket Policy must instead
be used. This should only be set for older buckets.
* `partsize` - Amazon S3 only accepts uploads up to a certian file size,
and storing larger files requires a multipart upload process.