From c75873947b5fab4efeff2fbd5fe10106707fc842 Mon Sep 17 00:00:00 2001 From: developerjamiu Date: Thu, 19 Nov 2026 13:27:35 +0100 Subject: [PATCH] docs: Note the CDN cache clear on the Deployments page --- cloud_docs/concepts/deployments.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/cloud_docs/concepts/deployments.md b/cloud_docs/concepts/deployments.md index 4f13af13..10e0ccd6 100644 --- a/cloud_docs/concepts/deployments.md +++ b/cloud_docs/concepts/deployments.md @@ -20,6 +20,12 @@ Deploy your project to Cloud: serverpod cloud deploy ``` +The command also takes these flags: + +- `-v` (`--verbose`): Shows detailed output. +- `--dart-version`: Overrides the Dart SDK used at build time. +- `--concurrency=`: Sets how many files are zipped in parallel during packaging (default `5`). + The CLI packages your project, uploads it, and waits for the new version to go live. Once the deployment is live, your project is reachable at its default URLs: - Web: `https://.serverpod.space/` @@ -28,11 +34,9 @@ The CLI packages your project, uploads it, and waits for the new version to go l To use your own URL instead, see [Custom domains](/cloud/concepts/custom-domains). -Other flags: - -- `-v` (`--verbose`): detailed output. -- `--dart-version`: override the Dart SDK used at build time. -- `--concurrency=`: how many files are zipped in parallel during packaging (default `5`). +:::note +Your web content is served through a [CDN](/cloud/concepts/cdn). Each successful deploy clears its cached copies, so the new version is served without waiting for the old copies to expire. +::: To regenerate code or run other tasks before each deploy, configure a pre-deploy hook. See [Deployment hooks](/cloud/concepts/deployment-hooks). @@ -163,4 +167,5 @@ For a step-by-step walkthrough, see [Recover from a failed deploy](/cloud/guides - [Private dependencies](/cloud/reference/private-dependencies) for private package access during the build. - [Ship non-Dart files with your server](/cloud/guides/ship-non-dart-files) for shipping static assets like configuration and templates. - [Deploy from CI with GitHub Actions](/cloud/guides/deploy-from-ci-with-github-actions) for shipping every push. +- [Content delivery and caching](/cloud/concepts/cdn) for how the CDN caches your web content and clears it on every deploy. - [Scale to zero](/cloud/concepts/scale-to-zero) for how an idle project stops its server and starts it again on the next request.