Configurar almacenamiento remoto

El módulo Almacenamiento remoto proporciona la opción de almacenar archivos multimedia y programar importaciones y exportaciones en un contenedor de almacenamiento remoto persistente mediante un servicio de almacenamiento, como AWS S3.

De forma predeterminada, la aplicación de Adobe Commerce almacena los archivos multimedia en el mismo sistema de archivos que contiene la aplicación. Esto no es eficaz para configuraciones complejas de varios servidores y puede provocar una reducción del rendimiento al compartir recursos. Con el módulo Almacenamiento remoto, puede almacenar archivos multimedia en el directorio pub/media e importar o exportar archivos en el directorio var del almacenamiento de objetos remotos para aprovechar el cambio de tamaño de las imágenes del lado del servidor.

recommendation-more-help

No puede tener habilitado simultáneamente el almacenamiento remoto y el almacenamiento de la base de datos. Debe deshabilitar el almacenamiento de la base de datos antes de habilitar el almacenamiento remoto.

bin/magento config:set system/media_storage_configuration/media_database 0

Si habilita el almacenamiento remoto, podría afectar a su experiencia de desarrollo establecida. Por ejemplo, algunas funciones de archivo PHP podrían no funcionar como se esperaba. Se debe aplicar el uso de Commerce Framework para operaciones de archivo. La lista de funciones nativas de PHP prohibidas está disponible en el repositorio magento-coding-standard.

INFO
  • El almacenamiento remoto solo está disponible para la versión 2.4.2 y posteriores de Commerce. Ver las notas de la versión 2.4.2.

  • El módulo de almacenamiento remoto tiene compatibilidad con limited en Adobe Commerce en la infraestructura en la nube. El Adobe no puede solucionar por completo el problema del servicio del adaptador de almacenamiento de terceros. Consulte Configuración del almacenamiento remoto para Commerce en la infraestructura en la nube para obtener instrucciones sobre la implementación del almacenamiento remoto para proyectos en la nube.

imagen de esquema

Opciones de almacenamiento remoto

Puede configurar el almacenamiento remoto mediante la opción remote-storage con el comando setup de CLI. La opción remote-storage utiliza la siguiente sintaxis:

--remote-storage-<parameter-name>="<parameter-value>"

parameter-name hace referencia al nombre de parámetro de almacenamiento remoto específico. En la tabla siguiente se enumeran los parámetros disponibles para configurar el almacenamiento remoto:

Parámetro de línea de comandos
Nombre del parámetro
Descripción
Valor predeterminado
remote-storage-driver
conductor
Nombre del adaptador
Valores posibles:
archivo: Deshabilita el almacenamiento remoto y usa el sistema de archivos local
aws-s3: Use el servicio Amazon Simple Storage (Amazon S3)
ninguno
remote-storage-bucket
cubo
Almacenamiento de objetos o nombre de contenedor
ninguno
remote-storage-prefix
prefijo
Prefijo opcional (ubicación dentro del almacenamiento de objetos)
vaciar
remote-storage-region
región
Nombre de región
ninguno
remote-storage-key
tecla de acceso
Clave de acceso opcional
vaciar
remote-storage-secret
clave secreta
Clave secreta opcional
vaciar

Adaptadores de almacenamiento

La ubicación de almacenamiento predeterminada se encuentra en el sistema de archivos local. Un adaptador de almacenamiento le permite conectarse a un servicio de almacenamiento y almacenar sus archivos en cualquier lugar. Commerce admite la configuración de los siguientes servicios de almacenamiento:

Habilitar almacenamiento remoto

Puede instalar almacenamiento remoto durante una instalación de Adobe Commerce o agregar almacenamiento remoto a una instancia de Commerce existente. Los siguientes ejemplos muestran cada método utilizando un conjunto de remote-storage parámetros con comandos CLI de Commerce setup. Como mínimo, debe proporcionar el almacenamiento driver, bucket y region.

  • Ejemplo: Instalar Commerce con almacenamiento remoto

    code language-bash
    bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
  • Ejemplo: Habilitar el almacenamiento remoto en Commerce existente

    code language-bash
    bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
TIP
Para Adobe Commerce sobre la infraestructura en la nube, consulte Configuración del almacenamiento remoto para Commerce en la infraestructura en la nube.

Migrar contenido

Después de habilitar el almacenamiento remoto para un adaptador específico, puede usar la CLI para migrar los archivos media existentes al almacenamiento remoto.

./magento2ce/bin/magento remote-storage:sync
INFO
El comando sync solo migra archivos en el directorio pub/media, no los archivos de importación y exportación en el directorio var. Consulte Importación/Exportación programada en la Guía del usuario de Commerce 2.4.
386822bd-e32c-40a8-81c2-ed90ad1e198c