docs: Make file-upload storage setup the default path for S3, GCP, and R2 - #763
Conversation
|
|
|
Thanks for the review: |
|
The storage API was renamed in serverpod/serverpod#5621 yesterday, and #765 updated this page on main this morning. That's why the branch conflicts now. The overlap is the first two sections, "Upload a file" and "Access stored files". Main has rewritten both for the new API, so your edits there aren't needed any more. The rest of your work still applies: the provider sections, the passwords.yaml examples, the pub.dev links, and the us-central1 fix. Rebase on main and keep those. Line 33 also needs dropping. It says S3 and HMAC GCP ignore preventOverwrite, which was correct when you wrote it. It now throws instead, and main has the new wording. |
…d R2 Give each provider a single setup path, document s3_compat as a building block, and correct the GCP HMAC region and preventOverwrite behavior.
Label the unrestricted path example, restore fromServiceAccountJson, and warn against root-user AWS keys.
393db97 to
7552dfc
Compare
|
The branch is rebased, and the old preventOverwrite ignore wording is gone |
serverpod/serverpod#3470 is a pub.dev packaging audit. This PR updates the File uploads page so it is the canonical setup path those packages can link to. It does not close that issue.
S3, GCP, and R2 each get one default setup path. Native GCP and custom S3-compatible endpoints stay as labelled variants. The GCP HMAC region example is
us-central1instead ofauto.Rebased onto main after #765. The Upload a file and Access stored files sections keep the renamed storage API. Unsupported options, including
preventOverwriteon providers that do not support it, throw.Test plan