Spostare i file nell'object storage.
Porta in un bucket i file da Amazon S3, Google Cloud Storage, qualsiasi storage compatibile S3 o una cartella del tuo server: copia tutto in una volta, oppure sposta gradualmente senza interruzioni.
Hai già i file da un'altra parte? Spostali in un bucket della tua applicazione in uno dei due modi. Entrambi partono dal pannello: l'applicazione → Storage → il bucket → Sposta qui i file.
| Copia tutto ora | Sposta gradualmente, senza interruzioni | |
|---|---|---|
| Cosa succede | tutti i file vengono copiati in una volta | un file viene copiato la prima volta che la tua applicazione lo legge |
| Quando far passare la tua applicazione | a copia terminata | subito |
| Avanzamento | file trovati, copiati, saltati, non copiati; pausa, ripresa, interruzione | attivo finché non lo disattivi |
| Vecchio storage | Amazon S3, Google Cloud Storage, compatibile S3 | Amazon S3, Google Cloud Storage |
La copia avviene da parte nostra — il tuo computer non deve restare acceso. Quando è finita (o se si ferma prima della fine) ricevi un'email e un messaggio su Telegram.
Lo spostamento dei file è disponibile per il titolare dell'account e gli Amministratori dell'applicazione (vedi Accesso del team), e anche tramite API, CLI e MCP.
Prima di iniziare: una chiave in sola lettura
Crea nel tuo vecchio storage una chiave separata per questo spostamento che possa solo elencare e leggere quel bucket. Non incollare mai le tue chiavi principali. La chiave viene usata solo per questo spostamento; non la conserviamo e non viene più mostrata. Eliminala presso il vecchio fornitore quando lo spostamento è finito.
Amazon S3
In IAM, crea un utente (o un ruolo con una chiave di accesso) con questa policy — sostituisci my-old-bucket con il tuo 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/*"]
}
]
}Poi crea una chiave di accesso per l'utente. Nel pannello ti servono l'ID della chiave di accesso, la chiave di accesso segreta, il nome del bucket e la sua regione (ad esempio eu-central-1; è indicata accanto al bucket nella console S3).
Google Cloud Storage
Crea un account di servizio con accesso in lettura al bucket e scarica la sua chiave 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 legge i file; Storage Legacy Bucket Reader permette alla copia di leggere il bucket stesso. Nel pannello incolla l'intero contenuto di key.json. Poi elimina il file della chiave dal tuo computer.
Altri storage compatibili S3
Qualsiasi storage con API S3 funziona allo stesso modo: crea una chiave che possa solo elencare e leggere il bucket (la maggior parte dei fornitori la chiama chiave «read-only» o «restricted») e trova l'indirizzo S3 della regione del bucket — ad esempio https://s3.eu-central-003.backblazeb2.com. Inserisci l'indirizzo senza il nome del bucket.
Copia tutto ora
- L'applicazione → Storage → il bucket → Sposta qui i file.
- Scegli Copia tutto ora, il vecchio storage, il bucket lì, la regione o l'indirizzo S3, e incolla la chiave.
- Facoltativo: una cartella — ad esempio, copia solo
photos/. - File già presenti qui: per impostazione predefinita, se nel bucket c'è già un file con lo stesso nome viene mantenuto e quello del vecchio storage viene saltato. Attiva Sostituiscili per sovrascrivere.
- Avvia la copia e conferma.
La scheda mostra quanti file sono stati trovati, copiati, saltati e non copiati, con una barra di avanzamento; Mostra il log indica i file saltati o non copiati. Puoi Mettere in pausa, Riprendere o Interrompere la copia — i file già copiati restano. Quando la copia è finita, fai passare la tua applicazione al bucket (ha già le variabili S3_*).
I file mantengono i loro nomi (chiavi). Se esegui di nuovo la copia più avanti, viene copiato solo ciò che manca (con Sostituiscili disattivato).
Sposta gradualmente, senza interruzioni
Utile quando l'applicazione deve continuare a funzionare e i file vengono aggiunti di continuo:
- Sposta qui i file → Sposta gradualmente, senza interruzioni, il vecchio storage, il bucket e la chiave → Attiva lo spostamento graduale.
- Fai passare subito la tua applicazione a questo bucket (le sue variabili
S3_*) e fai il deploy. - Quando l'applicazione legge un file che non è ancora nel bucket, il file viene copiato dal vecchio storage in quel momento e servito. I nuovi upload vanno direttamente nel bucket.
- Per concludere: esegui Copia tutto ora per i file che nessuno ha ancora letto (con Sostituiscili disattivato, così restano i file più recenti), aspetta che sia finita, poi Disattiva lo spostamento graduale.
Finché non lo disattivi, il vecchio storage deve restare disponibile con la stessa chiave. I file mai letti e non copiati non vengono più recuperati dopo la disattivazione.
Da una cartella del tuo server
Per spostare file da un VPS o da qualsiasi altro server (ad esempio storage/app/public di un sito Laravel), usa rclone con le chiavi del bucket. Le trovi nella scheda Variabili dell'applicazione: S3_ENDPOINT, S3_BUCKET, S3_KEY e S3_SECRET (un secondo bucket ha il suo nome davanti: 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-wayrclone copy non elimina mai nulla nel bucket e salta i file già presenti e invariati, quindi puoi rilanciarlo dopo un'interruzione. Per una copia lunga eseguilo dentro tmux o screen sul server — così continua anche se la connessione SSH cade.
Quanto costa
Lo spostamento in sé non ha costi. I file nel bucket costano i normali prezzi dell'object storage, pagati dal tuo saldo:
- archiviazione: 0,025 USD per GB al mese — 50 GB costano circa 1,25 USD al mese;
- scritture: 6 USD per milione — ogni file copiato vale circa una scrittura, quindi 100.000 file costano circa 0,60 USD (un file molto grande viene caricato a parti e conta qualche scrittura);
- le letture fatte durante lo spostamento graduale sono letture normali (0,50 USD per milione).
La maggior parte dei fornitori di cloud storage fa pagare i dati in uscita (egress). Controlla il listino del tuo vecchio fornitore prima di spostare molti dati.
Per spostare i file serve un saldo positivo, come per aggiungere un bucket. Non è disponibile durante la prova gratuita né verso un bucket in sola lettura (oltre il limite di dimensione o oltre ciò che il saldo copre) — il pannello spiega il motivo e propone una ricarica quando serve. Se durante una copia il bucket passa in sola lettura, la copia si mette in pausa e riprende da sola appena è di nuovo possibile scrivere.
Limiti
- Una copia e uno spostamento graduale alla volta per bucket.
- I file più grandi di 1 TB vengono saltati dalla copia.
- I file in classi di archiviazione che vanno ripristinate prima della lettura (S3 Glacier Flexible Retrieval, Glacier Deep Archive) vengono saltati; ripristinali prima.
- Con un file si spostano solo i tuoi metadati (
x-amz-meta-*); l'ETag di un file può essere diverso da quello vecchio. - Un file eliminato dal bucket mentre lo spostamento graduale è attivo viene copiato di nuovo alla lettura successiva.