Empezar

Mover archivos al almacenamiento de objetos.

Trae archivos desde Amazon S3, Google Cloud Storage, cualquier almacenamiento compatible con S3 o una carpeta de tu servidor a un bucket: cópialo todo de una vez o muévelos poco a poco, sin cortes.

6 MIN DE LECTURA

¿Ya guardas tus archivos en otro sitio? Puedes moverlos a un bucket de tu aplicación de dos formas. Las dos empiezan en el panel: la aplicación → Almacenamiento → el bucket → Traer archivos.

Copiar todo ahoraMover poco a poco, sin cortes
Qué ocurretodos los archivos se copian de una vezun archivo se copia la primera vez que tu aplicación lo lee
Cuándo cambiar tu aplicacióncuando termina la copiaen el momento
Progresoarchivos encontrados, copiados, omitidos, no copiados; pausar, reanudar, deteneractivo hasta que lo desactives
Almacenamiento anteriorAmazon S3, Google Cloud Storage, compatible con S3Amazon S3, Google Cloud Storage

La copia se hace en nuestro lado: tu equipo no tiene que quedarse encendido. Cuando termina (o si se detiene antes de acabar) recibes un correo y un mensaje de Telegram.

Pueden mover archivos el titular de la cuenta y los Administradores de la aplicación (consulta Acceso del equipo), y también se puede hacer desde la API, la CLI y MCP.

Antes de empezar: una clave que solo pueda leer

Crea en tu almacenamiento anterior una clave aparte para este traslado que solo pueda listar y leer ese bucket. Nunca pegues tus claves principales. La clave se usa solo para este traslado; no la guardamos y no se vuelve a mostrar. Bórrala en el proveedor anterior cuando termine el traslado.

Amazon S3

En IAM, crea un usuario (o un rol con una clave de acceso) con esta política; sustituye my-old-bucket por tu 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/*"]
    }
  ]
}

Después crea una clave de acceso para él. En el panel necesitas el ID de la clave de acceso, la clave de acceso secreta, el nombre del bucket y su región (por ejemplo, eu-central-1; aparece junto al bucket en la consola de S3).

Google Cloud Storage

Crea una cuenta de servicio con acceso de lectura al bucket y descarga su clave 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 lee los archivos; Storage Legacy Bucket Reader permite a la copia leer el propio bucket. En el panel, pega todo el contenido de key.json. Después, borra el archivo de la clave de tu equipo.

Otros almacenamientos compatibles con S3

Cualquier almacenamiento con API de S3 funciona igual: crea una clave que solo pueda listar y leer el bucket (la mayoría de los proveedores la llaman clave «de solo lectura» o «restringida») y busca la dirección S3 de la región del bucket, por ejemplo https://s3.eu-central-003.backblazeb2.com. Escribe la dirección sin el nombre del bucket.

Copiar todo ahora

  1. La aplicación → Almacenamiento → el bucket → Traer archivos.
  2. Elige Copiar todo ahora, el almacenamiento anterior, el bucket de allí, la región o la dirección S3, y pega la clave.
  3. Opcional: una carpeta, por ejemplo para copiar solo photos/.
  4. Archivos que ya están aquí: por defecto, si en el bucket ya hay un archivo con el mismo nombre, se conserva y el del almacenamiento anterior se omite. Activa Sustituirlos para sobrescribirlos.
  5. Iniciar la copia y confirma.

La tarjeta muestra cuántos archivos se han encontrado, copiado, omitido y no copiado, con una barra de progreso; Ver registro indica los archivos omitidos o que no se pudieron copiar. Puedes Pausar, Reanudar o Detener la copia: los archivos ya copiados se quedan. Cuando termine la copia, cambia tu aplicación al bucket (ya tiene las variables S3_*).

Los archivos conservan sus nombres (claves). Si vuelves a lanzar la copia más adelante, solo se copia lo que falta (con Sustituirlos desactivado).

Mover poco a poco, sin cortes

Útil cuando la aplicación tiene que seguir funcionando y se añaden archivos constantemente:

  1. Traer archivos → Mover poco a poco, sin cortes, el almacenamiento anterior, el bucket y la clave → Activar el traslado gradual.
  2. Cambia tu aplicación a este bucket en ese momento (sus variables S3_*) y despliega.
  3. Cuando la aplicación lee un archivo que aún no está en el bucket, se copia del almacenamiento anterior en ese momento y se sirve. Las subidas nuevas van directamente al bucket.
  4. Para terminar: lanza Copiar todo ahora para los archivos que nadie ha leído todavía (con Sustituirlos desactivado, para que se queden los archivos más nuevos), espera a que acabe y luego Desactiva el traslado gradual.

Hasta que lo desactives, el almacenamiento anterior debe seguir disponible con la misma clave. Los archivos que nunca se leyeron ni se copiaron ya no se traen una vez desactivado.

Desde una carpeta de tu servidor

Para mover archivos desde un VPS o cualquier otro servidor (por ejemplo, storage/app/public de un sitio Laravel), usa rclone con las claves propias del bucket. Las encontrarás en la pestaña Variables de la aplicación: S3_ENDPOINT, S3_BUCKET, S3_KEY y S3_SECRET (un segundo bucket lleva su nombre delante: 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 nunca borra nada del bucket y omite los archivos que ya están allí sin cambios, así que puedes volver a lanzarlo después de una pausa. Para una copia larga, ejecútalo dentro de tmux o screen en el servidor: así sigue adelante aunque se corte tu conexión SSH.

Cuánto cuesta

El traslado en sí no tiene coste. Los archivos del bucket cuestan los precios habituales del almacenamiento de objetos y se pagan de tu saldo:

  • almacenamiento: 0,025 US$ por GB al mes; 50 GB cuestan unos 1,25 US$ al mes;
  • escrituras: 6 US$ por millón; cada archivo copiado equivale más o menos a una escritura, así que 100 000 archivos cuestan unos 0,60 US$ (un archivo muy grande se sube por partes y cuenta como varias escrituras);
  • las lecturas hechas durante el traslado gradual son lecturas normales (0,50 US$ por millón).

La mayoría de los proveedores de almacenamiento en la nube cobran por los datos que salen de ellos (egress). Consulta la lista de precios de tu proveedor anterior antes de mover muchos datos.

Para mover archivos necesitas saldo positivo, igual que para añadir un bucket. No está disponible durante la prueba gratuita ni hacia un bucket en solo lectura (por encima de su límite de tamaño o de lo que cubre el saldo); el panel explica el motivo y ofrece recargar cuando eso lo soluciona. Si mientras se hace una copia el bucket pasa a solo lectura, la copia se pausa y continúa sola cuando se puede volver a escribir.

Límites

  • Una copia y un traslado gradual a la vez por bucket.
  • La copia omite los archivos de más de 1 TB.
  • Se omiten los archivos en clases de archivo que hay que restaurar antes de leerlos (S3 Glacier Flexible Retrieval, Glacier Deep Archive); restáuralos primero.
  • Con un archivo solo se mueven tus propios metadatos (x-amz-meta-*); el ETag de un archivo puede ser distinto del anterior.
  • Un archivo borrado del bucket mientras el traslado gradual está activo se vuelve a copiar la próxima vez que se lea.

¿Sigues con dudas?

Escríbenos por chat: la AI responde al momento y un ingeniero se une cuando hace falta, a cualquier hora del día.

Contactar con soporte