オンデマンド移行

空のローカルバケットを作成するCopy Anchor Link

Console で Browser → Buckets を開き、migration というバケットを作成して、オブジェクトがないことを確認します。ソースを接続する準備ができたら、そのバケットの Settings を開きます。

オンデマンド移行を開くCopy Anchor Link

1. バケット migration を開き、Settings を選びます。
2. Automation を選びます。
3. On-demand migration を見つけます。
4. 未設定なら Open migration settings または + Enable on-demand migration を選びます。すでに有効なら Manage migration を選びます。

この手順の未設定ページには、移行ソースが未設定であることと、+ Enable on-demand migration が表示されます。

ソースを有効にすると、Automation に Migration active と Manage migration が表示されます。

バケットを Cloudflare R2 に向けるCopy Anchor Link

Enable on-demand migration でソースを次のように設定します。アカウント ID とキーは自分の R2 トークンに置き換えます。トークンがセッショントークンを要求しない場合、セッショントークンは空にします。ソース名前空間全体を対象にするには Local prefix を空にします。この手順では追加のプレフィックスを保存していません（All keys、No added prefix）。

接続をテストして移行を有効にするCopy Anchor Link

Test connection を選びます。成功すると Connection test passed と、ソースバケットのサンプルオブジェクトキーが表示されます。その後 Enable migration を選びます。

同じ結果はトーストでも表示されます。

設定状態は Migration active になります。読み取りかバックフィルが起きるまで、Runtime status の移行済みオブジェクトと移行済みデータは 0 のままです。Latest job は No backfill yet のままです。

rc cp でオブジェクトを 1 つ取得するCopy Anchor Link

rc でローカルバケットを読みます。このリクエストを R2 エンドポイントへ送らないでください。この手順ではローカルバケットがまだ空で、欠落していたオブジェクトを 1 つ取り込みました。最初のミスはオブジェクトをクライアントへ返し、ローカルへ保存します。同じキーの次の読み取りは RustFS が返します。

rc cp rustfs/migration/artifacts/rustfs/packages/nightly/rustfs-nightly-2026-11-02.deb /tmp/

rustfs/migration/artifacts/rustfs/packages/nightly/rustfs-nightly-2026-11-02.deb -> /tmp/rustfs-nightly-2026-11-02.deb (71.34 MiB)

ソースバケットにこのオブジェクトがない場合は、別のキーを使います。端末セッションには、この rc cp と、その後のローカル nightly プレフィックスに対する rc ls が写っています。一覧はオブジェクトがローカルに存在したあとのプレフィックスです。上の 1 回の rc cp が 71.34 MiB の取り込みです。

Cloudflare ダッシュボードに表示されていた、ソース側の同じ nightly プレフィックスです。

そのダッシュボードのバケットサイズは、Cloudflare が示すバケット全体の合計です。このページ後半の RustFS カウンタは、移行ジョブが報告した値です。

単一オブジェクトの取り込み後、Console の Browser にローカルバケットのそのオブジェクトが表示されます。

プレフィックスをバックフィルするCopy Anchor Link

Start backfill はソースを走査し、まだローカルにないキーを取り込みます。この手順のダイアログでは次の設定を使いました。

Dry run は一致するオブジェクトを一覧するだけで、キューに入れず、オブジェクトも書きません。プレフィックスを確認してから Dry run をオフにして取り込みます。

手順中に記録したプレフィックス一覧の抜粋です。ラボの記録では先頭のキーが切れています。完全なキーは artifacts/rustfs/packages/nightly/rustfs-nightly-2026-10-29.deb の形です。タイムスタンプは当時の記録で、おおよそ UTC です。完全な一覧はこの抜粋より長くなります。

…ghtly-2026-10-29.deb
[2026-11-02 03:25:08]  70.36 MiB artifacts/rustfs/packages/nightly/rustfs-nightly-2026-10-30.deb
[2026-11-02 03:25:08]  70.65 MiB artifacts/rustfs/packages/nightly/rustfs-nightly-2026-10-31.deb
[2026-11-02 03:25:08]  71.15 MiB artifacts/rustfs/packages/nightly/rustfs-nightly-2026-11-01.deb
[2026-11-02 03:14:39]  71.34 MiB artifacts/rustfs/packages/nightly/rustfs-nightly-2026-11-02.deb
[2026-11-02 03:25:08]  71.34 MiB artifacts/rustfs/packages/nightly/rustfs-nightly-latest.deb

バックフィルがオブジェクトを書き込んでいる間、Console は一覧済み件数と取り込み済み件数を表示します。ソースの走査が続いている間は、完了割合を表示しません。

ドライランのあと、ソース名前空間をバックフィルするCopy Anchor Link

設定済みのソース名前空間を走査するには、Source listing prefix を空にします。先に Dry run を実行して一覧を確認します。その後 Dry run をオフにしてバックフィルを開始します。

この手順のドライランは、オブジェクトを一覧しただけで取り込みはありませんでした。

その後、プレフィックスを空にして実行した全体のバックフィルは次の結果でした。

バケットを確認するCopy Anchor Link

オンデマンド移行のページで確認します。

1. Runtime status — 移行済みオブジェクトと移行済みデータが 0 ではなく、取り込み失敗が記録されていない。
2. Background backfill — 最新ジョブに、一覧、取り込み、スキップ、失敗の件数が表示されている。
3. Browser と rc — 上の端末セッションのように rc ls でプレフィックスを一覧し、ローカルにあるキーを rc cp で再度読む。

この手順のランタイムパネルは Migrated data が 8.1 GiB、Migrated objects が 128 でした。最新のバックフィルは Listed 128、Pulled 127、Skipped 1、Failed objects 0、Data 8.0 GiB でした。

手順後のバケット一覧では、migration が 128 オブジェクト、8.1 GiB になっています。