docs(cloud): Add a storage concept page - #771
Conversation
Covers the two default storages, choosing private vs public, registering a storage on the server, adding one in the console, the file browser, deletion, and plan limits. The ServerpodCloudStorage class has not landed in the framework yet, so the two registration snippets carry TODO markers to be replaced with the real class, package, and import before this merges. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01N237K5XruApUeGphztg8nc
|
Reworked against Serverpod 4.0.0 and Cloud CLI 1.0.0.
Your blockers are resolved: the provider API shipped, projects get both default storages, and the Storage tab is live and ungated. I first cut the custom-storage registration step, thinking server code could reach only |
SandPod
left a comment
There was a problem hiding this comment.
Have a couple of questions for you before I approve.
I assume that all has been tested with the latest version of the CLI/Console.
Isakdl
left a comment
There was a problem hiding this comment.
Looking good, but added some clarification comments on some section that I think needs a rework.
SandPod
left a comment
There was a problem hiding this comment.
Looks good from my perspective.
But still unsure about the code examples from the Framework. Easy that this gets outdated. Perhaps this is better suited for a guide?
|
The code left here is Cloud's own wiring, not the framework API. The API lives on the file-uploads page (#857), and the CDN and passwords pages carry the same kind of snippet. |
Adds
cloud_docs/concepts/storage.md, a concept page for Serverpod Cloud storage.It covers the two storages every project starts with, choosing access, using storage from server code, managing storages and their files from the CLI and the console, and what happens at a plan limit.
The blockers listed on this PR are resolved. The provider API shipped in Serverpod 4.0.0, projects are created with both default storages, and the console Storage tab is live and no longer gated. The page is updated against Serverpod 4.0.0 and Cloud CLI 1.0.0:
ServerpodCloudProvider.private()and.public(), whichserverpod createalready adds to new projects, and thesession.storageexamples use the shipped method names.serverpod cloud storagecommands, which the first draft did not cover, including creating and deleting a storage.privateandpublicas storage ids named after their access rather than as fixed categories.The console workflow, its labels, the storage id rules, and the type-the-storage-id delete confirmation were all checked against source.