Mulai sekarang

Memindahkan file ke object storage.

Pindahkan file dari Amazon S3, Google Cloud Storage, penyimpanan apa pun yang kompatibel dengan S3, atau folder di server Anda ke bucket: salin semuanya sekaligus, atau pindahkan bertahap tanpa downtime.

5 MENIT BACA

Sudah menyimpan file di tempat lain? Pindahkan ke bucket aplikasi Anda dengan salah satu dari dua cara. Keduanya dimulai dari panel: aplikasi → Storage → bucket → Pindahkan file ke sini.

Salin semuanya sekarangPindahkan bertahap, tanpa downtime
Yang terjadisetiap file disalin sekaligusfile disalin saat pertama kali dibaca oleh aplikasi Anda
Kapan mengalihkan aplikasi Andasetelah penyalinan selesaisaat itu juga
Progresfile ditemukan, disalin, dilewati, tidak disalin; jeda, lanjutkan, hentikanaktif sampai Anda menonaktifkannya
Penyimpanan lamaAmazon S3, Google Cloud Storage, kompatibel S3Amazon S3, Google Cloud Storage

Penyalinan berjalan di sisi kami — komputer Anda tidak perlu tetap menyala. Saat selesai (atau jika berhenti sebelum selesai), Anda menerima email dan pesan Telegram.

Pemindahan file tersedia untuk pemilik akun dan Administrator aplikasi (lihat Akses tim), dan juga melalui API, CLI, dan MCP.

Sebelum mulai: key yang hanya bisa membaca

Buat key terpisah khusus untuk pemindahan ini di penyimpanan lama Anda, yang hanya bisa menampilkan daftar dan membaca satu bucket tersebut. Jangan pernah menempelkan key utama Anda. Key hanya dipakai untuk pemindahan ini; kami tidak menyimpannya, dan key tidak akan ditampilkan lagi. Hapus key di penyedia lama setelah pemindahan selesai.

Amazon S3

Di IAM, buat user (atau role dengan access key) dengan policy berikut — ganti my-old-bucket dengan bucket Anda:

{
  "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/*"]
    }
  ]
}

Lalu buat access key untuknya. Di panel, Anda memerlukan access key ID, secret access key, nama bucket, dan region-nya (misalnya eu-central-1; ditampilkan di samping bucket di konsol S3).

Google Cloud Storage

Buat service account dengan akses baca ke bucket dan unduh key JSON-nya:

gcloud iam service-accounts create rivervo-move --display-name="Move files to 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 membaca file; Storage Legacy Bucket Reader memungkinkan proses penyalinan membaca bucket itu sendiri. Di panel, tempelkan seluruh isi key.json. Setelah itu, hapus file key dari komputer Anda.

Penyimpanan lain yang kompatibel dengan S3

Penyimpanan apa pun dengan API S3 bekerja dengan cara yang sama: buat key yang hanya bisa menampilkan daftar dan membaca bucket (sebagian besar penyedia menyebutnya key «read-only» atau «restricted»), dan cari alamat S3 untuk region bucket — misalnya https://s3.eu-central-003.backblazeb2.com. Masukkan alamat tanpa nama bucket.

Salin semuanya sekarang

  1. Aplikasi → Storage → bucket → Pindahkan file ke sini.
  2. Pilih Salin semuanya sekarang, penyimpanan lama, bucket di sana, region atau alamat S3, lalu tempelkan key.
  3. Opsional: sebuah folder — misalnya hanya salin photos/.
  4. File yang sudah ada di sini: secara default, file dengan nama yang sama yang sudah ada di bucket dipertahankan dan file dari penyimpanan lama dilewati. Aktifkan Timpa untuk menimpanya.
  5. Mulai penyalinan dan konfirmasi.

Kartu menampilkan jumlah file yang ditemukan, disalin, dilewati, dan tidak disalin, dengan progress bar; Tampilkan log menyebutkan file yang dilewati atau tidak bisa disalin. Anda bisa Jeda, Lanjutkan, atau Hentikan penyalinan — file yang sudah disalin tetap ada. Setelah penyalinan selesai, alihkan aplikasi Anda ke bucket (aplikasi sudah memiliki variabel S3_*).

File tetap memakai namanya (key). Menjalankan penyalinan lagi nanti hanya menyalin yang belum ada (dengan Timpa nonaktif).

Pindahkan bertahap, tanpa downtime

Berguna jika aplikasi harus tetap berjalan dan file terus ditambahkan:

  1. Pindahkan file ke sini → Pindahkan bertahap, tanpa downtime, penyimpanan lama, bucket, dan key → Aktifkan pemindahan bertahap.
  2. Langsung alihkan aplikasi Anda ke bucket ini (variabel S3_*-nya) lalu deploy.
  3. Saat aplikasi membaca file yang belum ada di bucket, file disalin dari penyimpanan lama saat itu juga lalu disajikan. Unggahan baru langsung masuk ke bucket.
  4. Untuk menyelesaikan: jalankan Salin semuanya sekarang untuk file yang belum pernah dibaca (dengan Timpa nonaktif, agar file yang lebih baru tetap ada), tunggu sampai selesai, lalu Nonaktifkan pemindahan bertahap.

Sampai Anda menonaktifkannya, penyimpanan lama harus tetap tersedia dengan key yang sama. File yang tidak pernah dibaca dan tidak disalin tidak akan diambil lagi setelah fitur ini nonaktif.

Dari folder di server Anda

Untuk memindahkan file dari VPS atau server lain (misalnya storage/app/public dari website Laravel), gunakan rclone dengan key milik bucket itu sendiri. Temukan key tersebut di tab Variabel aplikasi: S3_ENDPOINT, S3_BUCKET, S3_KEY, dan S3_SECRET (bucket kedua memiliki namanya di depan: MEDIA_S3_KEY …).

# Instal rclone (Linux)
curl https://rclone.org/install.sh | sudo bash
 
# Key bucket sebagai variabel environment — tidak tersimpan di file konfigurasi
export RCLONE_CONFIG_RIVERVO_TYPE=s3
export RCLONE_CONFIG_RIVERVO_PROVIDER=Other
export RCLONE_CONFIG_RIVERVO_REGION=auto
export RCLONE_CONFIG_RIVERVO_ENDPOINT='nilai S3_ENDPOINT'
export RCLONE_CONFIG_RIVERVO_ACCESS_KEY_ID='nilai S3_KEY'
export RCLONE_CONFIG_RIVERVO_SECRET_ACCESS_KEY='nilai S3_SECRET'
 
# Salin folder ke bucket (nilai S3_BUCKET), dengan struktur folder tetap sama
rclone copy /var/www/shop/storage/app/public rivervo:BUCKET/public --progress --transfers 16
 
# Pastikan setiap file sudah sampai
rclone check /var/www/shop/storage/app/public rivervo:BUCKET/public --one-way

rclone copy tidak pernah menghapus apa pun di bucket dan melewati file yang sudah ada tanpa perubahan, sehingga Anda bisa menjalankannya lagi setelah terputus. Untuk penyalinan yang lama, jalankan di dalam tmux atau screen di server — dengan begitu proses tetap berjalan meskipun koneksi SSH Anda terputus.

Biayanya

Tidak ada biaya untuk pemindahan itu sendiri. File di bucket dikenai harga object storage biasa, dibayar dari saldo Anda:

  • penyimpanan: US$0,025 per GB per bulan — 50 GB sekitar US$1,25 per bulan;
  • penulisan: US$6,00 per juta — setiap file yang disalin kira-kira satu penulisan, jadi 100.000 file sekitar US$0,60 (file yang sangat besar diunggah per bagian dan dihitung beberapa penulisan);
  • pembacaan selama pemindahan bertahap adalah pembacaan biasa (US$0,50 per juta).

Sebagian besar penyedia cloud storage mengenakan biaya untuk data yang keluar (egress). Periksa daftar harga penyedia lama Anda sebelum memindahkan data dalam jumlah besar.

Pemindahan file memerlukan saldo positif, sama seperti saat menambahkan bucket. Fitur ini tidak tersedia selama uji coba gratis dan tidak bisa ke bucket yang hanya-baca (melebihi batas ukurannya, atau melebihi yang bisa dibayar oleh saldo) — panel menjelaskan alasannya dan menawarkan isi saldo jika itu membantu. Jika bucket menjadi hanya-baca saat penyalinan berjalan, penyalinan dijeda dan berlanjut dengan sendirinya begitu penulisan kembali memungkinkan.

Batasan

  • Satu penyalinan dan satu pemindahan bertahap sekaligus per bucket.
  • File yang lebih besar dari 1 TB dilewati oleh proses penyalinan.
  • File di kelas arsip yang harus dipulihkan dulu sebelum dibaca (S3 Glacier Flexible Retrieval, Glacier Deep Archive) dilewati; pulihkan dulu file tersebut.
  • Hanya metadata Anda sendiri (x-amz-meta-*) yang ikut berpindah bersama file; ETag file bisa berbeda dari yang lama.
  • File yang dihapus dari bucket saat pemindahan bertahap aktif akan disalin lagi saat dibaca berikutnya.

Masih ada kendala?

Chat dengan kami — AI langsung menjawab dan engineer bergabung bila diperlukan, kapan saja.

Hubungi dukungan