Configurar o armazenamento remoto
O módulo de Armazenamento remoto oferece a opção de armazenar arquivos de mídia e agendar importações e exportações em um contêiner de armazenamento remoto persistente usando um serviço de armazenamento, como o AWS S3.
Por padrão, o aplicativo do Adobe Commerce armazena arquivos de mídia no mesmo sistema de arquivos que contém o aplicativo. Isso é ineficiente para configurações complexas de vários servidores e pode resultar em redução do desempenho ao compartilhar recursos. Com o módulo de Armazenamento Remoto, você pode armazenar arquivos de mídia no diretório pub/media e importar/exportar arquivos no diretório var do armazenamento de objetos remoto para aproveitar o redimensionamento de imagens do lado do servidor.
Você não pode ter armazenamento remoto e armazenamento de banco de dados habilitados ao mesmo tempo. Você deve desabilitar o armazenamento do banco de dados antes de habilitar o armazenamento remoto.
bin/magento config:set system/media_storage_configuration/media_database 0
A habilitação do armazenamento remoto pode afetar sua experiência de desenvolvimento estabelecida. Por exemplo, certas funções de arquivo PHP podem não funcionar como esperado. O uso do Commerce Framework para operações de arquivos deve ser empregado. A lista de funções nativas proibidas do PHP está disponível no repositório magento-coding-standard.
-
O armazenamento remoto está disponível somente para o Commerce versão 2.4.2 e posterior. Consulte as notas de versão do 2.4.2.
-
O módulo de armazenamento remoto tem suporte limitado no Adobe Commerce na infraestrutura em nuvem. O Adobe não pode solucionar problemas completamente com o serviço de adaptador de armazenamento de terceiros. Consulte Configurar armazenamento remoto para a infraestrutura do Commerce na nuvem para obter orientação sobre como implementar o armazenamento remoto em projetos na nuvem.
Opções de armazenamento remoto
Você pode configurar o armazenamento remoto usando a opção remote-storage com o comando 🔗 da CLI setup. A opção remote-storage usa a seguinte sintaxe:
--remote-storage-<parameter-name>="<parameter-value>"
parameter-name refere-se ao nome do parâmetro de armazenamento remoto específico. A tabela a seguir lista os parâmetros disponíveis para configurar o armazenamento remoto:
remote-storage-driverValores possíveis:
arquivo: desabilita o armazenamento remoto e usa o sistema de arquivos local
aws-s3: Use o Serviço de Armazenamento Simples da Amazon (Amazon S3)
remote-storage-bucketremote-storage-prefixremote-storage-regionremote-storage-keyremote-storage-secretAdaptadores de armazenamento
O local de armazenamento padrão está no sistema de arquivos local. Um adaptador de armazenamento permite que você se conecte a um serviço de armazenamento e armazene seus arquivos em qualquer lugar. Commerce dá suporte à configuração dos seguintes serviços de armazenamento:
Habilitar armazenamento remoto
Você pode instalar o armazenamento remoto durante uma instalação do Adobe Commerce ou adicionar armazenamento remoto a uma instância existente do Commerce. Os exemplos a seguir demonstram cada método usando um conjunto de parâmetros remote-storage com comandos CLI do Commerce setup. No mínimo, você deve fornecer o armazenamento driver, bucket e region.
-
Exemplo: instalar o Commerce com armazenamento remoto
code language-bash bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1" -
Exemplo: habilitar o armazenamento remoto no 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"
Migrar conteúdo
Depois de habilitar o armazenamento remoto para um adaptador específico, você pode usar a CLI para migrar arquivos de mídia existentes para o armazenamento remoto.
./magento2ce/bin/magento remote-storage:sync
pub/media, não os arquivos de importação/exportação no diretório var. Consulte Importação/Exportação agendada no Guia do Usuário do Commerce 2.4.