docs(deploy): mark R2 attachments mount experimental; sync anchor

Claude-Session: https://claude.ai/code/session_01NWpwXBqxrPZdv75ud8xszr
This commit is contained in:
Daniel Bodnar 2026-07-23 02:23:24 -05:00
parent 406d3a720f
commit 26687784b7
No known key found for this signature in database
2 changed files with 9 additions and 5 deletions

View File

@ -21,12 +21,12 @@
"bindings": [{ "class_name": "Sandbox", "name": "Sandbox" }]
},
"migrations": [{ "tag": "v1", "new_sqlite_classes": ["Sandbox"] }],
// Optional: durable attachment storage. Paperclip's upload directory is
// FUSE-mounted from this bucket (credential-less, via the Worker binding),
// so attachments survive container recycling. To enable:
// Optional (experimental): durable attachment storage. Paperclip's upload
// directory is FUSE-mounted from this bucket (credential-less, via the
// Worker binding), so attachments survive container recycling. To enable:
// 1. npx wrangler r2 bucket create paperclip-attachments
// 2. Uncomment the block below and redeploy.
// See docs/deploy/cloudflare.md#durable-attachments-via-r2-optional.
// See docs/deploy/cloudflare.md#durable-attachments-via-r2-optional-experimental.
// "r2_buckets": [
// { "binding": "ARTIFACTS", "bucket_name": "paperclip-attachments" }
// ],

View File

@ -28,7 +28,11 @@ npx wrangler secret put DATABASE_URL
The Worker forwards `DATABASE_URL` into the container and Paperclip uses it
instead of embedded Postgres.
## Durable Attachments via R2 (Optional)
## Durable Attachments via R2 (Optional, Experimental)
> **Experimental:** this mount path is newer than the rest of the deployment
> and has not yet been validated on a live deployment. The default (no R2
> binding) is unaffected.
Uploaded files (issue attachments, images) can survive container recycling
without any Paperclip configuration: the Worker FUSE-mounts an R2 bucket at