Skip to content

docs: add Cloudflare R2 on-demand migration guide - #193

Merged
majinghe merged 2 commits into
mainfrom
cursor/odm-r2-howto-089b
Nov 2, 2026
Merged

majinghe merged 2 commits into
mainfrom
cursor/odm-r2-howto-089b

Conversation

@majinghe

@majinghe majinghe commented Nov 2, 2026 •

Copy link
Copy Markdown
Collaborator

Adds an illustrated how-to for RustFS on-demand migration from Cloudflare R2, based on the Console v1.0.3 lab notes.

The page sits under Administration → Data → Bucket, next to bucket replication. It lists the eight Provider values from the Console (Amazon S3, S3-compatible storage, MinIO, RustFS, Cloudflare R2, Google Cloud Storage (HMAC), Azure Blob Storage (Native), and Google Cloud Storage (Native)). Cloudflare R2 is the worked example. Other providers use the same flow; only the endpoint, credential, and bucket fields change.

The R2 steps cover attaching a read-only source, Test connection → Enable migration, then three pulls: a single-object GET miss with rc cp (71.34 MiB), a prefix backfill, and a full-namespace dry run followed by backfill (Listed 128, Pulled 127, Skipped 1, Failed 0, Data 8.0 GiB).

Pages

  • English: content/en/administration/data/bucket/on-demand-migration.md
  • Chinese: content/zh/administration/data/bucket/on-demand-migration.md
  • German, French, and Japanese counterparts are included so docs-check locale parity stays intact

Screenshots are English Console captures in each locale’s sibling images/ folder, including rustfs-console-on-demand-migration-source-providers.png. Account IDs, access keys, and the lab hostname are replaced with placeholders. On-demand migration is described as an inbound pull, separate from outbound bucket replication, and the page does not claim that local copies keep following the source.

Checks

  • npm run docs:check — pass
  • npm run build (Node 24) — pass

Omitted because it was not verifiable

  • No server flag, config file, or environment variable for turning the feature on. The lab notes say enablement depends on the deployment, but they do not name one. The page documents the Console flow only.
  • Per-provider endpoint and credential formats beyond the R2 example. The Console lists the providers; this page does not invent connection strings for the others.
  • rc stat is named in the lab checklist without a command or output. Verification uses rc ls and a second rc cp, which the terminal session shows.
  • The optional “read again after disconnecting the source” check was left unchecked in the lab notes.
  • Chinese Console screenshots were not published. The style guide requires English UI.
  • Jurisdiction-specific R2 hostnames are not listed. The lab says to use the endpoint Cloudflare shows, and only the default https://<account-id>.r2.cloudflarestorage.com form was recorded.
Open in Web Open in Cursor 

Document the Console v1.0.3 walkthrough for attaching a read-only R2 bucket and pulling objects on a read miss, a prefix backfill, and a full-namespace dry run plus backfill.

Co-authored-by: hector <majinghe@users.noreply.github.com>
@vercel

vercel Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs-rustfs-com Ready Ready Preview Nov 2, 2026 5:18am UTC

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
rustfs-docs 8f162b4 Commit Preview URL

Branch Preview URL
Nov 02 2026, 05:22 AM

State that the Console Provider menu supports eight sources and that the how-to uses Cloudflare R2 as the worked example.

Co-authored-by: hector <majinghe@users.noreply.github.com>
@majinghe
majinghe merged commit fd7c2a9 into main Nov 2, 2026
5 checks passed
@majinghe
majinghe deleted the cursor/odm-r2-howto-089b branch November 2, 2026 06:24

This branch was successfully deployed

1 active deployment
Preview — 8f162b4c Deployed Nov 2, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant