docs(fast-deploy): client onboarding runbook#26
Merged
Conversation
How to enable fast-deploy for a new site: the read side (worker DECO_KV + DECO_FAST_DEPLOY) and write side (Deco CR fastDeploy) that must both be wired, KV namespace provisioning + seeding, verification, constraints, troubleshooting, and rollback. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
docs/fast-deploy-onboarding.md— the step-by-step for turning fast-deploy on for a new client.Covers the two-sides mental model (worker read path +
DecoCR write trigger, sharing one KV namespace id), the one-time platform prerequisites, per-client steps (KV namespace → worker binding/var → seed →Deco.spec.fastDeploy→ test), constraints (one namespace/site, single CF account, content-only pushes), a troubleshooting table, and rollback.🤖 Generated with Claude Code
Summary by cubic
Adds
docs/fast-deploy-onboarding.md, a step-by-step runbook to enable KV-first fast-deploy for new client sites so.deco/blocks/**content goes live in ~10s withoutwrangler deploy. It explains the worker read path,DecoCR write trigger, required Cloudflare KV setup, testing, constraints, troubleshooting, and rollback.DECO_KV, and setDECO_FAST_DEPLOY=1on the site’s worker (uses@decocms/startKV read path).npx -p @decocms/start deco-migrate-blocks-to-kv --write.DecoCR withfastDeploy.enabled: trueand the matchingkvNamespaceId; verify via the org GitHub webhook and a content push.Written for commit 6a08aed. Summary will update on new commits.