オブジェクトストレージへのファイルの移行。
Amazon S3、Google Cloud Storage、S3互換ストレージ、またはサーバー上のフォルダからバケットへファイルを移行します。一括でコピーすることも、ダウンタイムなしで段階的に移行することもできます。
ファイルを別の場所に保存している場合は、次の2つの方法のいずれかでアプリのバケットに移行できます。どちらもパネルから開始します:アプリ → ストレージ → バケット → ファイルを移行。
| 今すぐすべてコピー | ダウンタイムなしで段階的に移行 | |
|---|---|---|
| 動作 | すべてのファイルを一度にコピー | アプリが初めて読み取ったときにファイルをコピー |
| アプリを切り替える時期 | コピー完了後 | すぐに |
| 進行状況 | 検出、コピー済み、スキップ、コピー不可の件数。一時停止、再開、停止が可能 | オフにするまで有効 |
| 移行元のストレージ | Amazon S3、Google Cloud Storage、S3互換 | Amazon S3、Google Cloud Storage |
コピーは当社側で実行されるため、お使いのコンピューターを起動したままにする必要はありません。完了したとき(または途中で停止したとき)は、メールとTelegramでお知らせします。
ファイルの移行は、アカウントの所有者とアプリの管理者(チームのアクセスをご覧ください)が行えます。API、CLI、MCPからも実行できます。
始める前に:読み取り専用のキー
移行元のストレージで、対象のバケットの一覧表示と読み取りのみができる今回の移行専用のキーを作成してください。メインのキーは絶対に貼り付けないでください。キーは今回の移行にのみ使用し、保存せず、再表示もされません。移行が完了したら、移行元のプロバイダーでキーを削除してください。
Amazon S3
IAMで、次のポリシーを持つユーザー(またはアクセスキー付きのロール)を作成します。my-old-bucketはご利用のバケット名に置き換えてください。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:List*", "s3:Get*"],
"Resource": ["arn:aws:s3:::my-old-bucket", "arn:aws:s3:::my-old-bucket/*"]
}
]
}次に、そのユーザーのアクセスキーを作成します。パネルでは、アクセスキーID、シークレットアクセスキー、バケット名、バケットのリージョン(例:eu-central-1。S3コンソールでバケットの横に表示されます)が必要です。
Google Cloud Storage
バケットへの読み取りアクセス権を持つサービスアカウントを作成し、JSONキーをダウンロードします。
gcloud iam service-accounts create rivervo-move --display-name="Rivervoへのファイル移行"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
--member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.objectViewer"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
--member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.legacyBucketReader"
gcloud iam service-accounts keys create key.json \
--iam-account="rivervo-move@MY-PROJECT.iam.gserviceaccount.com"Storage Object Viewerでファイルを読み取り、Storage Legacy Bucket Readerでバケット自体を読み取れるようにします。パネルにはkey.jsonの内容をすべて貼り付けてください。その後、キーファイルはお使いのコンピューターから削除してください。
その他のS3互換ストレージ
S3 APIに対応したストレージであれば、同じ方法で移行できます。バケットの一覧表示と読み取りのみができるキー(多くのプロバイダーでは「読み取り専用」または「制限付き」キーと呼ばれます)を作成し、バケットのリージョンのS3アドレス(例:https://s3.eu-central-003.backblazeb2.com)を確認してください。アドレスはバケット名を含めずに入力します。
今すぐすべてコピー
- アプリ → ストレージ → バケット → ファイルを移行。
- 今すぐすべてコピーを選び、移行元のストレージ、そのバケット、リージョンまたはS3アドレスを指定して、キーを貼り付けます。
- 任意:フォルダを指定すると、たとえば
photos/だけをコピーできます。 - すでにあるファイル:初期設定では、バケットに同じ名前のファイルがある場合はそれを残し、移行元のファイルはスキップします。上書きするには置き換えるをオンにします。
- コピーを開始を押して確認します。
カードには、検出、コピー済み、スキップ、コピー不可のファイル数が進行状況バーとともに表示されます。ログを表示では、スキップされたファイルやコピーできなかったファイルの名前を確認できます。一時停止、再開、コピーを停止も可能で、コピー済みのファイルはそのまま残ります。コピーが完了したら、アプリをバケットに切り替えてください(S3_*の変数はすでに設定されています)。
ファイル名(キー)はそのまま保持されます。後でもう一度コピーを実行すると、不足しているファイルのみがコピーされます(置き換えるがオフの場合)。
ダウンタイムなしで段階的に移行
アプリを動かし続ける必要があり、ファイルが常に追加される場合に便利です。
- ファイルを移行 → ダウンタイムなしで段階的に移行で、移行元のストレージ、バケット、キーを指定 → 段階的な移行をオン。
- すぐにアプリをこのバケット(その
S3_*変数)に切り替えてデプロイします。 - アプリがまだバケットにないファイルを読み取ると、その時点で移行元のストレージからコピーして配信します。新しくアップロードされたファイルは直接バケットに保存されます。
- 完了するには、まだ誰も読み取っていないファイルのために今すぐすべてコピーを実行し(新しいファイルを残すため置き換えるはオフのまま)、完了を待ってから段階的な移行をオフにします。
オフにするまでは、移行元のストレージを同じキーで利用できる状態にしておく必要があります。オフにした後は、一度も読み取られずコピーされなかったファイルは取得されなくなります。
サーバー上のフォルダから
VPSやその他のサーバーからファイルを移行するには(例:Laravelサイトのstorage/app/public)、バケット専用のキーを使ってrcloneをご利用ください。キーはアプリの変数タブにあります:S3_ENDPOINT、S3_BUCKET、S3_KEY、S3_SECRET(2つ目のバケットは先頭に名前が付きます:MEDIA_S3_KEY …)。
# rcloneをインストール(Linux)
curl https://rclone.org/install.sh | sudo bash
# バケットのキーを環境変数として設定(設定ファイルには残りません)
export RCLONE_CONFIG_RIVERVO_TYPE=s3
export RCLONE_CONFIG_RIVERVO_PROVIDER=Other
export RCLONE_CONFIG_RIVERVO_REGION=auto
export RCLONE_CONFIG_RIVERVO_ENDPOINT='S3_ENDPOINTの値'
export RCLONE_CONFIG_RIVERVO_ACCESS_KEY_ID='S3_KEYの値'
export RCLONE_CONFIG_RIVERVO_SECRET_ACCESS_KEY='S3_SECRETの値'
# フォルダ構成を保ったまま、フォルダをバケット(S3_BUCKETの値)にコピー
rclone copy /var/www/shop/storage/app/public rivervo:BUCKET/public --progress --transfers 16
# すべてのファイルが届いたかを確認
rclone check /var/www/shop/storage/app/public rivervo:BUCKET/public --one-wayrclone copyはバケット内のファイルを削除せず、変更のない既存ファイルはスキップするため、中断後に再実行できます。長時間のコピーはサーバー上のtmuxまたはscreen内で実行してください。SSH接続が切れても処理が続きます。
費用
移行自体に料金はかかりません。バケット内のファイルには通常のオブジェクトストレージの料金がかかり、残高から支払われます。
- 保存容量:月額1GBあたり$0.025。50GBで月額約$1.25です。
- 書き込み:100万回あたり$6.00。コピーするファイル1つがおよそ1回の書き込みにあたるため、100,000ファイルで約$0.60です(非常に大きなファイルは分割してアップロードされ、数回の書き込みとして計算されます)。
- 段階的な移行中の読み取りは、通常の読み取りとして計算されます(100万回あたり$0.50)。
ほとんどのクラウドストレージプロバイダーは、データの送信(エグレス)に料金を請求します。大量のデータを移行する前に、移行元プロバイダーの料金表をご確認ください。
ファイルの移行には、バケットの追加と同じく残高がプラスであることが必要です。無料お試し期間中は利用できず、読み取り専用のバケット(容量上限を超えた、または残高で支払える範囲を超えたバケット)にも移行できません。パネルにはその理由が表示され、必要に応じてチャージをご案内します。コピー中にバケットが読み取り専用になった場合、コピーは一時停止し、書き込みが可能になると自動で再開します。
制限
- 1つのバケットにつき、同時に実行できるのはコピー1件と段階的な移行1件までです。
- 1TBを超えるファイルはコピーでスキップされます。
- 読み取る前に復元が必要なアーカイブクラスのファイル(S3 Glacier Flexible Retrieval、Glacier Deep Archive)はスキップされます。先に復元してください。
- ファイルとともに移行されるのは独自のメタデータ(
x-amz-meta-*)のみです。ファイルのETagは移行元と異なる場合があります。 - 段階的な移行が有効な間にバケットから削除したファイルは、次に読み取られたときに再度コピーされます。