Почати

Як перенести файли в об’єктне сховище.

Перенесіть файли з Amazon S3, Google Cloud Storage, будь-якого S3-сумісного сховища чи папки на вашому сервері в бакет: скопіюйте все одразу або переносьте поступово без простою.

6 ХВ ЧИТАННЯ

Уже зберігаєте файли деінде? Перенесіть їх у бакет вашого застосунку одним із двох способів. Обидва починаються в панелі: застосунок → Сховище → бакет → Перенести файли.

Скопіювати все заразПереносити поступово, без простою
Що відбуваєтьсяусі файли копіюються за один разфайл копіюється, коли застосунок уперше його читає
Коли перемикати застосунокпісля завершення копіюванняодразу
Прогресзнайдено, скопійовано, пропущено, не скопійовано файлів; пауза, продовження, зупинкапрацює, доки ви не вимкнете
Старе сховище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/*"]
    }
  ]
}

Потім створіть для нього ключ доступу. У панелі знадобляться ідентифікатор ключа доступу, секретний ключ доступу, назва бакета та його регіон (наприклад, eu-central-1; його показано біля бакета в консолі S3).

Google Cloud Storage

Створіть сервісний акаунт із доступом до бакета на читання й завантажте його JSON-ключ:

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 дає змогу читати файли; Storage Legacy Bucket Reader дає змогу копіюванню читати сам бакет. У панелі вставте весь вміст key.json. Після цього видаліть файл ключа зі свого комп’ютера.

Інші S3-сумісні сховища

Будь-яке сховище з S3 API працює так само: створіть ключ, який може лише переглядати список і читати бакет (більшість провайдерів називають його «read-only» або «restricted»), і знайдіть S3-адресу регіону бакета — наприклад, https://s3.eu-central-003.backblazeb2.com. Вводьте адресу без назви бакета.

Скопіювати все зараз

  1. Застосунок → Сховище → бакет → Перенести файли.
  2. Виберіть Скопіювати все зараз, старе сховище, бакет у ньому, регіон або S3-адресу й вставте ключ.
  3. За бажанням: папка — наприклад, щоб скопіювати лише photos/.
  4. Файли, які вже є тут: за замовчуванням, якщо файл із такою самою назвою вже є в бакеті, він лишається, а файл зі старого сховища пропускається. Увімкніть Замінювати їх, щоб перезаписувати.
  5. Почати копіювання й підтвердьте.

Картка показує, скільки файлів знайдено, скопійовано, пропущено й не скопійовано, а також смугу прогресу; Показати журнал називає файли, які пропущено або не вдалося скопіювати. Можна Призупинити, Продовжити або Зупинити копіювання — уже скопійовані файли лишаються. Коли копіювання завершиться, перемкніть застосунок на бакет (у нього вже є змінні S3_*).

Файли зберігають свої назви (ключі). Якщо пізніше запустити копіювання ще раз, буде скопійовано лише те, чого бракує (коли Замінювати їх вимкнено).

Переносити поступово, без простою

Цей спосіб зручний, коли застосунок має працювати безперервно, а файли постійно додаються:

  1. Перенести файли → Переносити поступово, без простою, старе сховище, бакет і ключ → Увімкнути поступове перенесення.
  2. Одразу перемкніть застосунок на цей бакет (його змінні S3_*) і розгорніть.
  3. Коли застосунок читає файл, якого ще немає в бакеті, файл копіюється зі старого сховища саме в цю мить і віддається. Нові завантаження йдуть одразу в бакет.
  4. Щоб завершити: запустіть Скопіювати все зараз для файлів, які ще ніхто не читав (з вимкненим Замінювати їх, щоб новіші файли лишилися), дочекайтеся завершення, а потім натисніть Вимкнути, щоб зупинити поступове перенесення.

Поки ви його не вимкнете, старе сховище має лишатися доступним із тим самим ключем. Файли, які жодного разу не читали й не скопіювали, після вимкнення більше не підтягуються.

З папки на вашому сервері

Щоб перенести файли з VPS чи будь-якого іншого сервера (наприклад, storage/app/public сайту на Laravel), скористайтеся rclone із власними ключами бакета. Їх можна знайти на вкладці Змінні застосунку: S3_ENDPOINT, S3_BUCKET, S3_KEY і S3_SECRET (у другого бакета перед ними стоїть його назва: MEDIA_S3_KEY …).

# Install rclone (Linux)
curl https://rclone.org/install.sh | sudo bash
 
# The bucket's keys as environment variables — they do not end up in a config file
export RCLONE_CONFIG_RIVERVO_TYPE=s3
export RCLONE_CONFIG_RIVERVO_PROVIDER=Other
export RCLONE_CONFIG_RIVERVO_REGION=auto
export RCLONE_CONFIG_RIVERVO_ENDPOINT='value of S3_ENDPOINT'
export RCLONE_CONFIG_RIVERVO_ACCESS_KEY_ID='value of S3_KEY'
export RCLONE_CONFIG_RIVERVO_SECRET_ACCESS_KEY='value of S3_SECRET'
 
# Copy the folder into the bucket (value of S3_BUCKET), keeping the folder structure
rclone copy /var/www/shop/storage/app/public rivervo:BUCKET/public --progress --transfers 16
 
# Check that every file arrived
rclone check /var/www/shop/storage/app/public rivervo:BUCKET/public --one-way

rclone copy ніколи нічого не видаляє в бакеті й пропускає файли, які там уже є без змін, тож після перерви його можна запустити знову. Для довгого копіювання запускайте його на сервері всередині tmux або screen — тоді воно не перерветься, якщо SSH-з’єднання обірветься.

Скільки це коштує

За саме перенесення плата не стягується. Файли в бакеті коштують за звичайними цінами об’єктного сховища й оплачуються з вашого балансу:

  • зберігання: 0,025 USD за ГБ на місяць — 50 ГБ коштують приблизно 1,25 USD на місяць;
  • запис: 6 USD за мільйон — кожен скопійований файл приблизно дорівнює одній операції запису, тож 100 000 файлів коштують близько 0,60 USD (дуже великий файл завантажується частинами й рахується як кілька операцій запису);
  • читання під час поступового перенесення — звичайні операції читання (0,50 USD за мільйон).

Більшість хмарних сховищ беруть плату за вихідний трафік (egress). Перш ніж переносити великий обсяг даних, перевірте прайс-лист старого провайдера.

Для перенесення файлів потрібен позитивний баланс, так само як і для додавання бакета. Перенесення недоступне під час безкоштовного пробного періоду й неможливе в бакет, що перебуває в режимі лише для читання (через перевищення ліміту розміру або коли баланс не покриває використання), — панель пояснить причину й запропонує поповнити баланс, якщо це допоможе. Якщо під час копіювання бакет переходить у режим лише для читання, копіювання стає на паузу й продовжується само, щойно запис знову стане можливим.

Обмеження

  • Одне копіювання й одне поступове перенесення на бакет одночасно.
  • Файли, більші за 1 ТБ, під час копіювання пропускаються.
  • Файли в архівних класах, які перед читанням потрібно відновити (S3 Glacier Flexible Retrieval, Glacier Deep Archive), пропускаються; спершу відновіть їх.
  • Разом із файлом переносяться лише ваші власні метадані (x-amz-meta-*); ETag файлу може відрізнятися від старого.
  • Файл, видалений із бакета під час поступового перенесення, буде скопійовано знову, коли його наступного разу прочитають.

Залишилися питання?

Напишіть нам у чат — AI відповідає одразу, а інженер підключається за потреби в будь-який час доби.

Написати в підтримку